`chatgpt_ads_list_custom_audiences`

List ChatGPT Ads Custom Audiences

Chatgpt

Description

List the custom audiences on the account — name, status, and how many identifiers matched. Its main use is resolving identity: chatgpt_ads_list_campaigns returns targeting.custom_audiences.ids as bare IDs, so pass those to custom_audience_ids here to find out who a campaign actually targets. Audience sizes come back as privacy-bucketed ranges (e.g. "5000-10000"), never exact counts — report them as ranges.

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chatgpt_ads_list_custom_audiences",
    "arguments": {
      "reason": "See what audiences exist"
    }
  }
}

hopkin chatgpt custom-audiences list

Flag	Type	Required	Description
`--limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`--custom-audience-ids`	`array`	Optional	Resolve specific audiences by ID instead of listing. Use this to turn the opaque IDs in a campaign's targeting.custom_audiences into names.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "chatgpt-ads": {
      "url": "https://chatgpt.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (4)

Name	Type	Required	Description
`limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.min: 1, max: 100
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`custom_audience_ids`	`array`	Optional	Resolve specific audiences by ID instead of listing. Use this to turn the opaque IDs in a campaign's targeting.custom_audiences into names.
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Examples

List audiences

{
  "reason": "See what audiences exist"
}

hopkin chatgpt custom-audiences list

Resolve targeting IDs

{
  "custom_audience_ids": [
    "ca_abc123"
  ],
  "reason": "Name the audiences a campaign targets"
}

hopkin chatgpt custom-audiences list --custom-audience-ids ca_abc123