OpenAI Ads MCP Server

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

answering

OpenAI Ads MCP is answering right now. Last checked 14 min ago. 123 installs a week from pypi. It exposes 13 tools. Last commit 22 Jul 2026.

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

Installs per day peak 132 · avg 15 · -74% w/w

a month agotoday

Uptime history 42 hours of history · worst hour 75%

42 hours agonow

98.9%

Uptime 24h

90 of 91 checks

Tools

read from the server

361 ms

Response time

average over 24h

123

Installs / week

npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

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

{
  "mcpServers": {
    "openai-ads-mcp": {
      "url": "https://openai-ads-mcp.trakkr.ai/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.openai-ads-mcp]
url = "https://openai-ads-mcp.trakkr.ai/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "openai-ads-mcp": {
      "url": "https://openai-ads-mcp.trakkr.ai/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "openai-ads-mcp": {
      "url": "https://openai-ads-mcp.trakkr.ai/mcp"
    }
  }
}

Available tools 13

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

account

get_account

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.

ads

list_ads

List ads in an ad group.

audience

get_audience

Get one custom audience by id.

audiences

list_audiences

List custom audiences for the authenticated ad account.

campaign

get_campaign

Get one campaign by id.

campaigns

list_campaigns

List campaigns in the authenticated ad account with cursor pagination.

draft

draft_context_hints

Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

geo

search_geo

Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

get

get_ad

Get one ad by id, including review_status and creative metadata.

group

get_ad_group

Get one ad group by id.

groups

list_ad_groups

List ad groups for a campaign.

insights

get_insights

Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

manage

manage_conversions

Manage conversion pixels, API keys, event settings, and conversion reporting.

Endpoints

URL	Transport	State	Latency	Checked
https://openai-ads-mcp.trakkr.ai/mcp	streamable-http	answering	323 ms	14 min ago

OpenAI Ads MCP — questions

Answers built from our own checks of this server.

What can OpenAI Ads MCP do?

It exposes 13 tools, read directly from the server on our last check. Among them: draft_context_hints, get_account, get_ad, get_ad_group, get_audience, get_campaign and 7 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is OpenAI Ads MCP working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 90 of 91 checks got a reply (98.9%), average response time 361 ms. The bar chart above shows every period we have measured.

How do I connect OpenAI Ads MCP?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does OpenAI Ads MCP need an API key?

No. OpenAI Ads MCP completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 13 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is OpenAI Ads MCP?

It answers our handshake in 361 ms on average, which is faster than 39% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use OpenAI Ads MCP?

The npm package openai-ads-mcp was installed 123 times in the last week. Week over week that is -74%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is OpenAI Ads MCP open source?

Yes — it is published under the MIT licence, written in TypeScript and 3 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.