Open sourceFree · MITRead-only

OpenAI Ads MCP: free, open-source ChatGPT Ads server

Read your ChatGPT Ads campaigns and reports from Claude, Cursor or VS Code in plain language. 11 read-only tools, runs on your machine with npx.

Running Google Ads or Meta next to ChatGPT Ads? See the HYPD connector

HYPD-AI / openai-ads-mcp

openai-ads-mcp

MCP server for the OpenAI Ads API. Read campaigns, ad groups, ads and performance insights from any MCP client.

6GitHub starsTypeScriptMIT
View on GitHub

What you can do with the OpenAI Ads MCP

The server wraps the read endpoints of the OpenAI Ads API as 11 MCP tools. Your assistant picks the tool, you ask the question.

Check your account and API key

Confirm your key works and which ad account it's tied to.

Try askingIs my OpenAI Ads API key working, and which ad account is it tied to?

Read campaigns, ad groups and ads

Objectives, budgets, targeting, bidding, creative and review status.

Try askingList my active campaigns with their budgets, then show which ads are still pending review.

Pull ChatGPT Ads reporting into any MCP client

Account, campaign, ad group or ad. Any date range, daily or total.

Try askingShow spend, clicks and CTR for each campaign over the last 30 days, by day.

Ask in plain language, skip the raw API

No request building, pagination cursors or micros arithmetic.

Try askingWhich campaign has spent the largest share of its lifetime budget so far?

Read-only today. The server never creates, edits or pauses anything and never spends budget. Write actions are planned and will need an explicit opt-in.

How the OpenAI Ads MCP works in 3 steps

It's published on npm, so there's nothing to clone or build.

Want the backstory? Read how we brought ChatGPT Ads to Claude.

  1. 1

    Create an API key

    Under Settings at ads.openai.com. One key per ad account.

  2. 2

    Add the server to your client

    Paste the block on this page into Claude Desktop, Cursor or VS Code. Needs Node.js 20 or newer.

  3. 3

    Ask your assistant

    “Use the openai-ads tools to look up my ad account.”

{
  "mcpServers": {
    "openai-ads": {
      "command": "npx",
      "args": ["-y", "@hypd-ai/openai-ads-mcp"],
      "env": {
        "OPENAI_ADS_API_KEY": "your-openai-ads-api-key"
      }
    }
  }
}

Goes in claude_desktop_config.json or ~/.cursor/mcp.json. Several ad accounts need several entries. VS Code and other clients

If something goes wrong
  • The tools don't appear: restart the client fully and check that the config file is valid JSON.
  • npx isn't found or fails: install Node.js 20 or newer and restart the client.
  • The API returns 401 or 403: check that OPENAI_ADS_API_KEY holds a valid key for the ad account you want to read.
  • Still stuck: run the server in the MCP Inspector to see each tool call, or open an issue on GitHub.

Who the ChatGPT Ads MCP is for

Pick the card that matches you.

Developers and agent builders

Full control. MIT licensed, TypeScript, pull requests welcome.

  • Build an agent that reports on ChatGPT Ads every morning.
  • Test how your own prompts use the 11 tools.
  • Fix or extend the server and send it back to the repo.
More

The OpenAI Ads API is young, and people building agents against it find the rough edges first. Every change has to pass linting, type checks and tests. For larger changes, open an issue first so we can agree on the approach. Use the MCP Inspector to watch each tool call while you build.

Small business owners

Safe reporting. It can't change a campaign or spend a dollar.

  • Ask which ads are still pending review.
  • Check yesterday's spend and clicks in one sentence.
  • Spot the campaign using its budget fastest.
More

If you're new to ChatGPT Ads, start with OpenAI's own Ads Manager at ads.openai.com or the official ChatGPT Ads Manager plugin. Add this server later if you want quick answers about results without opening a dashboard.

Agencies and multi-channel teams

Compare ChatGPT Ads with Google and Meta in one conversation.

  • Put ChatGPT Ads spend next to Google and Meta spend.
  • Give each client or teammate their own access.
  • Keep an audit trail on the channels you already run.
More

This server reads OpenAI Ads only. The HYPD connector covers Google Ads, Meta Ads, Google Analytics and Merchant Center, with per-user and per-client permissions and an audit log. OpenAI Ads is not part of the HYPD connector today, so run both in the same assistant.

How the OpenAI Ads manager MCP compares with the alternatives

There's no official OpenAI-published MCP server. The HYPD server's main weakness: it only reads.

OpenAI Ads MCP options compared
OptionTypeCan it write?PlatformsBest for
HYPD open-source serverLocal via npx. Free, MITRead-onlyOpenAI AdsDevelopers who want control and safe reporting
HYPD connectorSee the product Hosted in the EU. Free plan, paid from $19.99/monthRead-only by defaultGoogle Ads, Meta Ads, Google Analytics, Merchant Centernot OpenAI AdsTeams and agencies on several platforms
ChatGPT Ads Manager pluginofficial OpenAIPluginWrites, with confirmationChatGPT AdsAdvertisers who want OpenAI's own tool
OpenAI Ads ManagerWeb UIWritesChatGPT AdsBilling, verification, bulk upload, visual control

Details for non-HYPD rows come from vendor pages as reported by AI assistants, so check them before you buy. More comparisons

Pricing

The server is free. The HYPD connector has a free plan.

OpenAI Ads MCP server

$0

Free, MIT license.

HYPD connector

$0

Free plan, paid from $19.99/month.

OpenAI ad spend

—

Billed by OpenAI. The server doesn't change it.

FAQ

Still have a question? Open an issue on GitHub or talk to the team.

Talk to the team

This page is operated by HYPD Advertising Intelligence GmbH. The OpenAI Ads MCP is a community project, not affiliated with or endorsed by OpenAI.

Bring paid media into your AI, safely.

Install the server for ChatGPT Ads reporting, or connect the rest of your stack with HYPD.