x_ads_get_campaign_reach

Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths…

Get reach and average-frequency metrics for campaigns 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

Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`campaign_ids`	string	Required	Comma-separated campaign IDs to fetch reach for (max 20).
`end_time`	string	Required	ISO 8601 end of the metrics window (exclusive); must be in the past (a future end_time is rejected).
`start_time`	string	Required	ISO 8601 start of the metrics window.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_get_campaign_reach",
    "args": {
      "account_id": "<string>",
      "campaign_ids": "<string>",
      "end_time": "<string>",
      "start_time": "<string>"
    }
  }
}