OpenAI Ads MCP Server

by trakkr-aisearchio.github.trakkr-aisearch/openai-ads-mcpv0.1.7

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

3Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install OpenAI Ads MCP server

claude mcp add openai-ads-trakkr-aisearch -e OPENAI_ADS_API_KEY='<openai-ads-api-key>' -- npx -y openai-ads-mcp

{
  "mcpServers": {
    "openai-ads-trakkr-aisearch": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<openai-ads-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "openai-ads-trakkr-aisearch": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<openai-ads-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "openai-ads-trakkr-aisearch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<openai-ads-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "openai-ads-trakkr-aisearch": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<openai-ads-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OPENAI_ADS_API_KEY	yes	yes	OpenAI Ads API key from Ads Manager. Scoped to one ad account.
OPENAI_ADS_MCP_READONLY	—	—	Set to 1 for first connection so write tools are hidden.
OPENAI_ADS_BUDGET_CEILING_USD	—	—	Optional budget guard for spend-changing tools. Defaults to 100.

Remote endpoints

streamable-httphttps://openai-ads-mcp.trakkr.ai/mcp

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-22 · 3mo ago · GitHub
Latest release
2026-06-20 · 4mo ago · GitHub · openai-ads-mcp-v0.1.5
Package published
no data · npm/PyPI
Registry entry updated
2026-07-22 · 3mo ago · official registry · v0.1.7

FAQ

›How do I install the OpenAI Ads MCP server in Claude Code?

Run: claude mcp add openai-ads-trakkr-aisearch -e OPENAI_ADS_API_KEY='<openai-ads-api-key>' -- npx -y openai-ads-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does OpenAI Ads require an API key?

Yes. It expects OPENAI_ADS_API_KEY, of which 1 is a secret.

›Can I use OpenAI Ads as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is OpenAI Ads in the official MCP registry?

Yes, as io.github.trakkr-aisearch/openai-ads-mcp.