X Ads campaigns

Account ID

X Ads account ID selected in SourcesRequired · account_id

Campaign IDs

Comma-separated campaign IDs to scope the response toOptional · campaign_ids

Count

Number of records to return per page (1-1000)Optional · count

Cursor

Pagination cursor from a previous responseOptional · cursor

Funding instrument IDs

Comma-separated funding instrument IDs to scope the results to (max 200)Optional · funding_instrument_ids

Q

Search by campaign name (1-255 characters)Optional · q

Sort by

Sort order as attribute-direction, e.g. created_at-asc or updated_at-descOptional · sort_by

With deleted

Include soft-deleted campaigns in the response (default false)Optional · with_deleted

With draft

Include draft campaigns in the response (default false)Optional · with_draft

With total count

Include the total_count response attribute (default false; exclusive with cursor)Optional · with_total_count

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 account statsX 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 funding instrumentsX Ads$0.005
• X Ads line itemX Ads$0.005
• Compare all 16