x_ads_list_custom_audiences

List the custom audiences of an ads account, with their type, size and whether X can target them (targetable, reasons_not_targetable) Native X fields…

View as Markdown

List the custom audiences of an ads account, with their type, size and whether X can target them (targetable, reasons_not_targetable) 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

Parameters

Parameters
Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`count`	integer	Optional	Number of records to return per page (1-1000).
`cursor`	string	Optional	Pagination cursor from a previous response.
`custom_audience_ids`	string	Optional	Comma-separated custom audience IDs to fetch specific records (max 200).
`q`	string	Optional	Case-insensitive name prefix (1-255 characters).
`with_deleted`	boolean	Optional	Include deleted custom audiences (default false).

Calling it

json · Through run_tool, since it is not announced

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

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.