Skip to content
Get MCP AdsGet MCP Ads, home

x_ads_create_campaign

Create a campaign in an ads account. A write tool that previews before it changes anything, one of 26 X Ads tools on the Get MCP Ads MCP gateway.

Create a campaign in an ads account. The campaign is ALWAYS created with entity_status PAUSED ; it cannot serve or spend until explicitly activated with activate_campaign. Campaigns are always created with budget_optimization LINE_ITEM (the only mode ads-api still supports), so budgets are NOT set here: set daily_budget_amount_local_micro on each line item via create_line_item. Schedule (start_time/end_time) and pacing (standard_delivery) also live on line items, not campaigns, in ads-api v12. 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_tool
Account parameter
account_id
Endpoint
https://mcp.getmcpads.com/x-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
account_idstringRequiredX Ads account ID selected in Sources.
funding_instrument_idstringRequiredFunding instrument to bill this campaign to (from list_funding_instruments; must have able_to_fun...
namestringRequiredCampaign name (1-255 characters).
purchase_order_numberstringOptionalBooking reference / PO number carried onto invoices for invoice-billed accounts (max 50 characters).
confirmbooleanOptionalFalse previews only; true applies this exact change after explicit human confirmation. Default: false.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_create_campaign",
    "args": {
      "account_id": "<string>",
      "funding_instrument_id": "<string>",
      "name": "<string>"
    }
  }
}
Esc

Type to search