X Ads cards

Account ID

X Ads account ID selected in SourcesRequired · account_id

Card IDs

Comma-separated card IDs to fetch specific cards (max 200)Optional · card_ids

Card types

Comma-separated unified card types to filter by, e.g. IMAGE_WEBSITE, VIDEO_WEBSITE, IMAGE_APP, VI..Optional · card_types

Card uris

Comma-separated card URIs to fetch specific cards (max 200)Optional · card_uris

Count

Number of records to return per page (default 100, max 200)Optional · count

Cursor

Pagination cursor from a previous responseOptional · cursor

Include legacy cards

Include legacy (non-unified) cards in the response (default false)Optional · include_legacy_cards

Q

Search query matching against the card nameOptional · q

Sort by

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

With deleted

Include soft-deleted cards (default false)Optional · with_deleted

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

• Create an X Ads cardX Ads$0.05/change
• Create an X Ads media library itemX Ads$0.05/change
• Delete an X Ads cardX Ads$0.05/change
• Delete an X Ads media library itemX Ads$0.05/change
• Update an X Ads media library itemX Ads$0.05/change
• Upload X Ads mediaX Ads$0.05/change
• X Ads cardX Ads$0.005
• X Ads media libraryX Ads$0.005
• Compare all 10