Skip to content
MCP server

ChatGPT Ads

ChatGPT Ads reporting and paused campaign setup from an MCP client

Runs locallyStatus and history
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally
Version
1.0.2
Listing updated
2 days ago

About ChatGPT Ads

ChatGPT Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

OpenAI's ad platform has its own Ads Management API, and this server wraps it for assistants. Each API key is scoped to one ad account, and the server only ever uses that account's adacct_ ID. The key comes from Settings, then API Keys in OpenAI Ads Manager, and is separate from an OpenAI Platform key.

Reports cover spend, impressions, clicks and CTR by campaign, ad group or ad, with breakdowns by country, device or platform and a chosen attribution window. A separate conversion report shows which countries drive a campaign's results, and another explains why an ad is not serving.

The local npm package lists 30 read tools and 28 write tools. Writes are off by default, preview before applying, and activation, which can spend budget, needs its own switch. The hosted version adds a cockpit, a gallery of chat card images and daily trends.

Install

Run in a terminal

claude mcp add chatgpt-ads --env OPENAI_ADS_API_KEY='<OPENAI_ADS_API_KEY>' --env OPENAI_ADS_ACCOUNT_ID='<OPENAI_ADS_ACCOUNT_ID>' -- npx -y @getmcpads/chatgpt-ads-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chatgpt-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/chatgpt-ads-mcp-server"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chatgpt-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/chatgpt-ads-mcp-server"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "chatgpt-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/chatgpt-ads-mcp-server"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "chatgpt-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/chatgpt-ads-mcp-server"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "chatgpt-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/chatgpt-ads-mcp-server"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
        "OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Configuration

  • OPENAI_ADS_API_KEYAdvertiser API key from Ads Manager settings. Scoped to one ad account. Keep it secret.Required
  • OPENAI_ADS_ACCOUNT_IDThe adacct_ ID the key belongs to. The only account the server will use.Required
  • OPENAI_ADS_ENABLE_WRITEStrue exposes the write tools. Defaults to false. Writes preview before applying.
  • OPENAI_ADS_ENABLE_ACTIVATIONtrue allows activation, which can spend budget. Requires writes. Defaults to false.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

openai_ads_get_account
Fetches the ad account; the README says to call it first.
openai_ads_get_insights
Reports spend, impressions, clicks and CTR by campaign, ad group or ad.
openai_ads_get_conversion_insights
Shows conversions by country for a campaign or chat card.

What it does

Insight reports
Returns spend, impressions, clicks and CTR with breakdowns and attribution windows.
Conversions by country
Shows which countries drive a campaign's or chat card's conversions.
Serving diagnosis
Reports why an ad is not serving.
Paused campaign creation
Creates campaigns, ad groups and chat card ads paused; turning them on is a separate approved step.
Opt-in writes
Write tools are disabled by default and preview changes before applying them.
Activation guard
Activation needs its own setting on top of writes, since it can spend budget.

Good for

  • Report last week's spend and CTR by device
  • Check conversions on a 7-day click, 1-day view window
  • Find out why a chat card ad is not serving
  • Draft a new campaign that stays paused until approved

Pricing

Freemium, from $39 a month

Hosted: free for 1 account, Pro $39/mo, Team $99/mo; local npm package is free

Prices change. Check getmcpads.com before you buy.

ChatGPT Ads FAQ

How do I connect it?

Create an Ads Management API key in OpenAI Ads Manager, then set OPENAI_ADS_API_KEY and OPENAI_ADS_ACCOUNT_ID, or paste the key into the hosted service.

Can it spend my budget?

Only if you set OPENAI_ADS_ENABLE_WRITES and OPENAI_ADS_ENABLE_ACTIVATION to true. Both default to off.

Which accounts can it see?

Only the single ad account the key belongs to.

What does hosting cost?

The hosted service has a free plan for one ad account, Pro at $39 a month and Team at $99 a month.

Is ChatGPT Ads free?

ChatGPT Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

How do I add ChatGPT Ads to Claude Code?

Run this command in your terminal: claude mcp add chatgpt-ads --env OPENAI_ADS_API_KEY='<OPENAI_ADS_API_KEY>' --env OPENAI_ADS_ACCOUNT_ID='<OPENAI_ADS_ACCOUNT_ID>' -- npx -y @getmcpads/chatgpt-ads-mcp-server

What are the best alternatives to ChatGPT Ads?

The closest alternatives to ChatGPT Ads are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to ChatGPT Ads

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data