`chatgpt_ads_list_campaigns`

List ChatGPT Ads Campaigns

Chatgpt

Description

List campaigns in the ChatGPT Ads account, with optional status and name filtering. Budget and bid amounts are integer micros (1,000,000 micros = 1 unit of the account currency — see chatgpt_ads_get_ad_account). Pass campaign_ids to resolve specific campaigns by ID instead of listing. Cache-first: pass refresh: true to force a live fetch.

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chatgpt_ads_list_campaigns",
    "arguments": {
      "reason": "Show the account structure"
    }
  }
}

hopkin chatgpt campaigns 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.
`--refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`--campaign-ids`	`array`	Optional	Fetch specific campaigns by ID instead of listing, e.g. ["cmpn_abc123"]. Other filters are ignored when set.
`--status`	`array`	Optional	Filter by status: active, paused or archived. Case-insensitive. Applied client-side — the API has no status filter.
`--search`	`string`	Optional	Filter by name (case-insensitive substring match).
`--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 (7)

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.
`refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`campaign_ids`	`array`	Optional	Fetch specific campaigns by ID instead of listing, e.g. ["cmpn_abc123"]. Other filters are ignored when set.
`status`	`array`	Optional	Filter by status: active, paused or archived. Case-insensitive. Applied client-side — the API has no status filter.
`search`	`string`	Optional	Filter by name (case-insensitive substring match).minLength: 1, maxLength: 200
`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

All campaigns

{
  "reason": "Show the account structure"
}

hopkin chatgpt campaigns list

Active only

{
  "status": [
    "active"
  ],
  "reason": "Review what is currently delivering"
}

hopkin chatgpt campaigns list --status active

By ID

{
  "campaign_ids": [
    "cmpn_abc123"
  ],
  "reason": "Resolve a campaign id from an insights row"
}

hopkin chatgpt campaigns list --campaign-ids cmpn_abc123