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.

Installation Instructions

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

Package Details

• Package: openai-ads-mcp
• Version: 0.1.7
• Runtime: Python and Node
• Transport: stdio and Streamable HTTP
• Auth: OpenAI Ads API key, per request or env
• Registry: io.github.trakkr-aisearch/openai-ads-mcp
• License: MIT

Tool Coverage

Account

1. get_account

Campaigns

• list_campaigns
• get_campaign
• create_campaign
• update_campaign
• set_campaign_state

Ad groups

• list_ad_groups
• get_ad_group
• create_ad_group
• update_ad_group
• set_ad_group_state

Ads

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

Insights

• get_insights

Audiences

• list_audiences
• get_audience
• search_geo
• manage_audience

Conversions

• manage_conversions
• send_conversions

Workflows

• build_campaign
• draft_context_hints
• bulk_ab_test_hints

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

FAQ

What is the OpenAI Ads MCP Server?
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.

Is this also the ChatGPT Ads MCP?
Yes, it is referred to as the ChatGPT Ads MCP.

Is this the official OpenAI Ads MCP?
Yes, it connects with the OpenAI Advertiser API.

How do I install it in Claude, Cursor, or Codex?
Follow the installation instructions provided above.

Does it work with the OpenAI Advertiser API and ChatGPT Ads?
Yes, it is designed to work with both.

Will it spend money without asking?
No, it has safety defaults to prevent unexpected spending.

Is it open source?
Yes, it is open source under the MIT license.