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
openai-ads-mcp
MCP server for the OpenAI Ads API. Read campaigns, ad groups, ads and performance insights from any MCP client.
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
Create an API key
Under Settings at ads.openai.com. One key per ad account.
- 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
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.
| Option | Type | Can it write? | Platforms | Best for |
|---|---|---|---|---|
| HYPD open-source server | Local via npx. Free, MIT | Read-only | OpenAI Ads | Developers who want control and safe reporting |
| HYPD connectorSee the product | Hosted in the EU. Free plan, paid from $19.99/month | Read-only by default | Google Ads, Meta Ads, Google Analytics, Merchant Centernot OpenAI Ads | Teams and agencies on several platforms |
| ChatGPT Ads Manager pluginofficial OpenAI | Plugin | Writes, with confirmation | ChatGPT Ads | Advertisers who want OpenAI's own tool |
| OpenAI Ads Manager | Web UI | Writes | ChatGPT Ads | Billing, 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.
This page is operated by HYPD Advertising Intelligence GmbH. The OpenAI Ads MCP is a community project, not affiliated with or endorsed by OpenAI.