OpenAI Ads MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

OpenAI Ads MCP for ChatGPT Ads campaigns, creatives, audiences, insights, and conversions.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "OpenAI Ads MCP": {
      "url": "https://openai-ads-mcp.trakkr.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• get_account read-only

  Get the authenticated OpenAI Ads account. Use this first to verify that OPENAI_ADS_API_KEY works and to read account id, name, timezone, currency, and settings.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_campaigns read-only

  List campaigns in the authenticated ad account with cursor pagination.

  Parameters:

  • after — string
  • limit — integer
  • order — string
  • before — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_campaign read-only

  Get one campaign by id.

  Parameters:

  • campaign_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_ad_groups read-only

  List ad groups for a campaign.

  Parameters:

  • campaign_id (required) — string
  • after — string
  • limit — integer
  • order — string
  • before — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_ad_group read-only

  Get one ad group by id.

  Parameters:

  • ad_group_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_ads read-only

  List ads in an ad group.

  Parameters:

  • ad_group_id (required) — string
  • after — string
  • limit — integer
  • order — string
  • before — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_ad read-only

  Get one ad by id, including review_status and creative metadata.

  Parameters:

  • ad_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_insights read-only

  Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

  Parameters:

  • scope (required) — string
  • sort
  • after — string
  • limit — integer
  • before — string
  • fields
  • filters
  • includes
  • segments
  • entity_id — string
  • time_range
  • response_format — string
  • time_granularity — string
  • aggregation_level — string
  • override_segment_group_order

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_audiences read-only

  List custom audiences for the authenticated ad account.

  Parameters:

  • after — string
  • limit — integer
  • order — string
  • before — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_audience read-only

  Get one custom audience by id.

  Parameters:

  • audience_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• search_geo read-only

  Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

  Parameters:

  • query (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• manage_conversions read-only

  Manage conversion pixels, API keys, event settings, and conversion reporting.

  Parameters:

  • action (required) — string
  • name — string
  • after — string
  • limit — integer
  • order — string
  • before — string
  • entity_ids
  • event_type — string
  • source_ids
  • client_type — string
  • time_ranges
  • aggregation_level — string
  • custom_event_name — string
  • attribution_window_days — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• draft_context_hints read-only

  Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

  Parameters:

  • product (required) — string
  • intent — string
  • audience — string
  • keywords

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.