X Ads account stats

Account ID

X Ads account ID selected in SourcesRequired · account_id

End time

ISO 8601 end of the metrics window (exclusive)Required · end_time

Entity

Entity type to fetch metrics forRequired · entity

Entity IDs

Comma-separated IDs of the entities to fetch metrics for (max 20)Required · entity_ids

Granularity

Granularity of the returned time series (DAY, HOUR or TOTAL)Required · granularity

Metric groups

Comma-separated metric groups, e.g. ENGAGEMENT,BILLING,VIDEO (max 10; MOBILE_CONVERSION groups mu..Required · metric_groups

Placement

Placement to scope the metrics to (ALL_ON_TWITTER or PUBLISHER_NETWORK)Required · placement

Start time

ISO 8601 start of the metrics window, e.g. 2026-07-01T00:00:00ZRequired · start_time

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• X Ads account postsX Ads$0.005
• X ads accountsX Ads$0.005
• X Ads active entitiesX Ads$0.005
• X Ads campaignX Ads$0.005
• X Ads campaign reachX Ads$0.005
• X Ads campaignsX Ads$0.005
• X Ads funding instrumentsX Ads$0.005
• X Ads line itemX Ads$0.005
• Compare all 16