Skip to content
Get MCP AdsGet MCP Ads, home

x_ads_list_campaigns

List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Source
X Ads
Kind
Read
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.
campaign_idsstringOptionalComma-separated campaign IDs to scope the response to.
countintegerOptionalNumber of records to return per page (1-1000).
cursorstringOptionalPagination cursor from a previous response.
funding_instrument_idsstringOptionalComma-separated funding instrument IDs to scope the results to (max 200).
qstringOptionalSearch by campaign name (1-255 characters).
sort_bystringOptionalSort order as attribute-direction, e.g. created_at-asc or updated_at-desc.
with_deletedbooleanOptionalInclude soft-deleted campaigns in the response (default false).
with_draftbooleanOptionalInclude draft campaigns in the response (default false).
with_total_countbooleanOptionalInclude the total_count response attribute (default false; exclusive with cursor).

Calling itLink to this section

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

Type to search