Skip to content

OpenAI Ads MCP

by trakkr-aisearch · remote · local (npm, pypi) · no sign-in to list tools · v0.1.7 · published by GitHub user trakkr-aisearch

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

Changes · 2
CompareRegistry entry

13 tools: 2 change things and 11 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http openai-ads https://openai-ads-mcp.trakkr.ai/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

13 tools

Changes things 2Claude Code: ask
  • draft_context_hintsDraft deterministic context_hints for an ad group from product, audience, intent, and keywords.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • manage_conversionsManage conversion pixels, API keys, event settings, and conversion reporting.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Manage conversion pixels, API keys, event settings, and conversion reporting.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
Only reads 11Claude Code: allow
  • get_accountGet the authenticated OpenAI Ads account.No findings

    Why it is in this group

    • The name "get_account" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_adGet one ad by id, including review_status and creative metadata.No findings

    Why it is in this group

    • The name "get_ad" says "get": a word for reading.
    Description, as the server wrote it
    Get one ad by id, including review_status and creative metadata.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_ad_groupGet one ad group by id.No findings

    Why it is in this group

    • The name "get_ad_group" says "get": a word for reading.
    Description, as the server wrote it
    Get one ad group by id.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_audienceGet one custom audience by id.No findings

    Why it is in this group

    • The name "get_audience" says "get": a word for reading.
    Description, as the server wrote it
    Get one custom audience by id.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_campaignGet one campaign by id.No findings

    Why it is in this group

    • The name "get_campaign" says "get": a word for reading.
    Description, as the server wrote it
    Get one campaign by id.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_insightsGet performance insights for account, campaign, ad group, or ad scope.No findings

    Why it is in this group

    • The name "get_insights" says "get": a word for reading.
    Description, as the server wrote it
    Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_ad_groupsList ad groups for a campaign.No findings

    Why it is in this group

    • The name "list_ad_groups" says "list": a word for reading.
    Description, as the server wrote it
    List ad groups for a campaign.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_adsList ads in an ad group.No findings

    Why it is in this group

    • The name "list_ads" says "list": a word for reading.
    Description, as the server wrote it
    List ads in an ad group.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_audiencesList custom audiences for the authenticated ad account.No findings

    Why it is in this group

    • The name "list_audiences" says "list": a word for reading.
    Description, as the server wrote it
    List custom audiences for the authenticated ad account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_campaignsList campaigns in the authenticated ad account with cursor pagination.No findings

    Why it is in this group

    • The name "list_campaigns" says "list": a word for reading.
    Description, as the server wrote it
    List campaigns in the authenticated ad account with cursor pagination.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • search_geoSearch geo targets for targeting.locations.include and return ids usable in campaign targeting.No findings

    Why it is in this group

    • The name "search_geo" says "search": a word for reading.
    Description, as the server wrote it
    Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.7. Values in angle brackets are yours to fill in.

claude mcp add --transport http openai-ads https://openai-ads-mcp.trakkr.ai/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__openai-ads__get_account",
      "mcp__openai-ads__list_campaigns",
      "mcp__openai-ads__get_campaign",
      "mcp__openai-ads__list_ad_groups",
      "mcp__openai-ads__get_ad_group",
      "mcp__openai-ads__list_ads",
      "mcp__openai-ads__get_ad",
      "mcp__openai-ads__get_insights",
      "mcp__openai-ads__list_audiences",
      "mcp__openai-ads__get_audience",
      "mcp__openai-ads__search_geo"
    ],
    "ask": [
      "mcp__openai-ads__manage_conversions",
      "mcp__openai-ads__draft_context_hints"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as openai-ads. Review it before you use it.