x_ads_list_cards

List the cards in an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Source: X Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: account_id
Endpoint: https://mcp.getmcpads.com/x-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`card_ids`	string	Optional	Comma-separated card IDs to fetch specific cards (max 200).
`card_types`	string	Optional	Comma-separated unified card types to filter by, e.g. IMAGE_WEBSITE, VIDEO_WEBSITE, IMAGE_APP, VI...
`card_uris`	string	Optional	Comma-separated card URIs to fetch specific cards (max 200).
`count`	integer	Optional	Number of records to return per page (default 100, max 200).
`cursor`	string	Optional	Pagination cursor from a previous response.
`include_legacy_cards`	boolean	Optional	Include legacy (non-unified) cards in the response (default false).
`q`	string	Optional	Search query matching against the card name.
`sort_by`	string	Optional	Sort order as attribute-direction, e.g. created_at-asc or updated_at-desc.
`with_deleted`	boolean	Optional	Include soft-deleted cards (default false).
`with_total_count`	boolean	Optional	Include the total_count response attribute (default false; exclusive with cursor).

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_list_cards",
    "args": {
      "account_id": "<string>"
    }
  }
}