x-ads / API Reference
x_ads_account_stats
X (Twitter) Ads tool, proxied to X's own Ads MCP gateway. Performance stats for X campaigns or line items. entity_ids is comma-separated, max 20 per call -- X's own limit on the synchronous endpoint. Times are ISO 8601. entity is ACCOUNT, FUNDING_INSTRUMENT, CAMPAIGN, LINE_ITEM, PROMOTED_TWEET or ORGANIC_TWEET. Run x_ads_active_entities first to find which ids actually moved.
This is a read-only tool: it returns x ads account stats for your x-ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
X ads account stats in my x-ads account for [entity ids], [start time], [end time].
It takes 4 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account Id |
entity_ids | string | Yes | Entity Ids |
start_time | string | Yes | Start Time |
end_time | string | Yes | End Time |
entity | string | No | Entity |
granularity | string | No | Granularity |
metric_groups | string | No | Metric Groups |
placement | string | No | Placement |
Related x-ads tools
x_ads_activate_campaignx_ads_active_entitiesx_ads_add_targetingx_ads_call_toolx_ads_campaign_reachx_ads_create_campaign
Before you can call it
This tool needs a connected x-ads account. The x-ads connect guide covers how to authorize it and what it unlocks, and the quickstart gets a client talking to the server in about five minutes.
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.