x_ads_create_card

Create a card from a JSON components payload. A write tool that previews before it changes anything, one of 56 X Ads tools on the Get MCP Ads MCP gateway.

View as Markdown

Create a card from a JSON components payload. Cards are immutable through this API (there is no update tool) ; to change a card, create a new one and promote a new post that uses the new card_uri. A card URL that must carry an ad ID takes two launches: launch 1 creates the campaign and line item (or the post whose ID is needed); read the ID from its results; launch 2 creates the card with that ID in its URL, then the post with its card_uri, promoted into that line item. A post cannot carry its own post ID: its card exists first. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Source: X Ads
Kind: Write
Discovery: Reachable through search_tools and run_write_tool
Account parameter: account_id
Endpoint: https://mcp.getmcpads.com/x-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`components`	array	Required	Card component objects, rendered top to bottom.
`name`	string	Required	Card name.
`confirm`	boolean	Optional	False previews only; true applies this exact change after explicit human confirmation. Default: `false`.

Calling it

json · Through run_write_tool, since it is not announced

{
  "name": "run_write_tool",
  "arguments": {
    "name": "x_ads_create_card",
    "args": {
      "account_id": "<string>",
      "components": "<array>",
      "name": "<string>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.