X Ads active entities

List which ads entities had metrics change in a time window (use before requesting account stats) Native X fields and pagination are preserved; monetary fields. Works on your own X Ads account, connected through Get MCP Ads. Needs account id, end time, entity and more.

Inputs

4 required

Account ID: X Ads account ID selected in SourcesRequired · account_id
End time: ISO 8601 end of the activity window (exclusive); must be a whole hour (minutes and seconds 0)Required · end_time
Entity: Entity type to check for metric activity (CAMPAIGN, FUNDING_INSTRUMENT, LINE_ITEM, MEDIA_CREATIVE, PROMOTED_ACCOUNT or PROMOTED_TWEET)Required · entity
Start time: ISO 8601 start of the activity window; must be a whole hour (minutes and seconds 0)Required · start_time
Campaign IDs: Comma-separated campaign IDs to scope the check to (max 200; exclusive with the other ids filters)Optional · campaign_ids
Funding instrument IDs: Comma-separated funding instrument IDs to scope the check to (max 200; exclusive with the other i..Optional · funding_instrument_ids
Line item IDs: Comma-separated line item IDs to scope the check to (max 200; exclusive with the other ids filters)Optional · line_item_ids
Workspace ID: Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price: $0.005 per call
Billing: The provider’s price, with no markup. Billed for measured usage.

Call

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

MCP call
cURL command
TypeScript
Tool ID

Alternatives

X Ads reporting

Connect your agent to 2,400+ tools for free

Get $5 free credit Get $5 free credit