# ChatGPT Ads

> ChatGPT Ads is a freemium MCP server for marketing and seo. ChatGPT Ads reporting and paused campaign setup from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** API, CLI, self-hosted, Web
- **Website:** https://www.getmcpads.com/tools/chatgpt-ads
- **Repository:** https://github.com/get-mcp-ads/chatgpt-ads-mcp-server
- **MCP Registry name:** com.getmcpads/chatgpt-ads
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/chatgpt-ads
