Open source·MIT·v0.1.7

OpenAI Ads MCP server.

The open-source MCP server for OpenAI Ads, ChatGPT Ads, and the OpenAI Advertiser API. Connect any MCP client and manage campaigns in plain English.

Also searched as the ChatGPT Ads MCP, because ChatGPT Ads run through OpenAI Ads and the OpenAI Advertiser API.

npx
$ export OPENAI_ADS_API_KEY="sk-ads-your-key"
export OPENAI_ADS_MCP_READONLY=1
npx -y openai-ads-mcp
Node 18+. Remove OPENAI_ADS_MCP_READONLY only when you want write tools visible.
Read-only first run. Per-request API key. Keys never stored.
npmPyPIGitHubMCP Registry
Packageopenai-ads-mcp
Also searched asChatGPT Ads MCP
Version0.1.7
RuntimePython and Node
Transportstdio and Streamable HTTP
AuthOpenAI Ads API key, per request or env
Registryio.github.trakkr-aisearch/openai-ads-mcp
LicenseMIT
[01]Tool coverage

Account

1
  • get_account

Campaigns

5
  • list_campaigns
  • get_campaign
  • create_campaign
  • update_campaign
  • set_campaign_state

Ad groups

5
  • list_ad_groups
  • get_ad_group
  • create_ad_group
  • update_ad_group
  • set_ad_group_state

Ads

6
  • list_ads
  • get_ad
  • upload_creative
  • create_ad
  • update_ad
  • set_ad_state

Insights

1
  • get_insights

Audiences

4
  • list_audiences
  • get_audience
  • search_geo
  • manage_audience

Conversions

2
  • manage_conversions
  • send_conversions

Workflows

3
  • build_campaign
  • draft_context_hints
  • bulk_ab_test_hints
Write action. Created paused, and hidden in read-only mode.
[02]Safety defaults

Read-only first run

The hosted endpoint is read-only, and the local install snippets set readonly so every write tool is hidden until you opt in.

OPENAI_ADS_MCP_READONLY=1

Writes created paused

New campaigns, ad groups, and ads are created paused. A budget ceiling guard blocks spend above your limit until you confirm.

OPENAI_ADS_BUDGET_CEILING_USD=100

Per-request API key

Pass your OpenAI Ads key per request or via env. It is never stored and never logged.

X-OpenAI-Ads-API-Key
[03]Built for OpenAI Ads, not retrofitted
Capability
openai-ads-mcp
Generic ads MCP
OpenAI Advertiser API
Native
ChatGPT Ads placements
Read-only first-run config
Rare
Writes created paused
Budget ceiling guard
Per-request API key
Varies
Streamable HTTP transport
Varies
Listed in the MCP Registry
Varies
License
MIT
Varies

Generic Google or Meta ads MCP servers target other ad networks. None speak the OpenAI Advertiser API.

[04]Close the loop with AI visibility
[05]FAQ

It is an open-source Model Context Protocol server that connects any MCP client, like Claude, Cursor, or Codex, to the OpenAI Advertiser API. Once connected, you can read accounts and insights and manage OpenAI Ads and ChatGPT Ads campaigns in plain English. It ships as the openai-ads-mcp package on npm and PyPI under an MIT license.

The OpenAI Ads MCP, open and cautious by design.

Install it in under a minute, read the source, and run your OpenAI Ads from the assistant you already use.

View on GitHubSee the Trakkr MCP