x_ads_get_account_stats

Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending…

Get synchronous analytics (impressions, engagements, spend) for an ads 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

Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`end_time`	string	Required	ISO 8601 end of the metrics window (exclusive).
`entity`	string	Required	Entity type to fetch metrics for. One of: `ACCOUNT`, `CAMPAIGN`, `FUNDING_INSTRUMENT`, `LINE_ITEM`, `MEDIA_CREATIVE`, `PROMOTED_ACCOUNT`, `PROMOTED_TWEET`, `ORGANIC_TWEET`.
`entity_ids`	string	Required	Comma-separated IDs of the entities to fetch metrics for (max 20).
`granularity`	string	Required	Granularity of the returned time series. One of: `DAY`, `HOUR`, `TOTAL`.
`metric_groups`	string	Required	Comma-separated metric groups, e.g. ENGAGEMENT,BILLING,VIDEO (max 10; MOBILE_CONVERSION groups mu...
`placement`	string	Required	Placement to scope the metrics to. One of: `ALL_ON_TWITTER`, `PUBLISHER_NETWORK`.
`start_time`	string	Required	ISO 8601 start of the metrics window, e.g. 2026-07-01T00:00:00Z.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_get_account_stats",
    "args": {
      "account_id": "<string>",
      "end_time": "<string>",
      "entity": "ACCOUNT",
      "entity_ids": "<string>",
      "granularity": "DAY",
      "metric_groups": "<string>",
      "placement": "ALL_ON_TWITTER",
      "start_time": "<string>"
    }
  }
}