MCP Server

OpenAI Ads MCP MCP Server

Name: OpenAI Ads MCP MCP Server
Author: io.github.trakkr-aisearch

io.github.trakkr-aisearch/openai-ads-mcp

Repository Registry

What is the OpenAI Ads MCP MCP server?

OpenAI and ChatGPT Ads tools for campaigns, creatives, audiences, and insights.

How to install OpenAI Ads MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENAI_ADS_API_KEY
required
secret
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.
X-OpenAI-Ads-API-Key
required
secret
OpenAI Ads API key from Ads Manager. Required for Ads API tool calls; discovery works without it.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openai-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<YOUR_OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_MCP_READONLY": "<YOUR_OPENAI_ADS_MCP_READONLY>",
        "OPENAI_ADS_BUDGET_CEILING_USD": "<YOUR_OPENAI_ADS_BUDGET_CEILING_USD>",
        "X-OpenAI-Ads-API-Key": "<YOUR_X_OPENAI_ADS_API_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "openai-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<YOUR_OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_MCP_READONLY": "<YOUR_OPENAI_ADS_MCP_READONLY>",
        "OPENAI_ADS_BUDGET_CEILING_USD": "<YOUR_OPENAI_ADS_BUDGET_CEILING_USD>",
        "X-OpenAI-Ads-API-Key": "<YOUR_X_OPENAI_ADS_API_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openai-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<YOUR_OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_MCP_READONLY": "<YOUR_OPENAI_ADS_MCP_READONLY>",
        "OPENAI_ADS_BUDGET_CEILING_USD": "<YOUR_OPENAI_ADS_BUDGET_CEILING_USD>",
        "X-OpenAI-Ads-API-Key": "<YOUR_X_OPENAI_ADS_API_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "openai-ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<YOUR_OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_MCP_READONLY": "<YOUR_OPENAI_ADS_MCP_READONLY>",
        "OPENAI_ADS_BUDGET_CEILING_USD": "<YOUR_OPENAI_ADS_BUDGET_CEILING_USD>",
        "X-OpenAI-Ads-API-Key": "<YOUR_X_OPENAI_ADS_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add openai-ads-mcp --env OPENAI_ADS_API_KEY=<YOUR_OPENAI_ADS_API_KEY> --env OPENAI_ADS_MCP_READONLY=<YOUR_OPENAI_ADS_MCP_READONLY> --env OPENAI_ADS_BUDGET_CEILING_USD=<YOUR_OPENAI_ADS_BUDGET_CEILING_USD> --env X-OpenAI-Ads-API-Key=<YOUR_X_OPENAI_ADS_API_KEY> -- npx -y openai-ads-mcp