HYPD-AI/openai-ads-mcp
HYPD-AI
TypeScript2updated 5mo ago
TypeScript2updated 5mo agoMCP server for OpenAI Ads / ChatGPT Ads. Manage campaigns, ad groups, ads, creatives, and insights through the OpenAI Ads Advertiser API.
ClaudeCodexCursorMCP
chatgptchatgpt-adsmcp-serveropenai-ads
README
openai-ads-mcp
A Model Context Protocol (MCP) server for the OpenAI Ads (Advertiser) API. It lets MCP-compatible clients — Claude Desktop, Cursor, VS Code, and others — read your OpenAI Ads campaigns, ad groups, ads, and performance insights through natural language.
Read-only. This first release only reads data — it never creates, edits, or pauses anything and never spends budget. Write actions are on the roadmap.
Unofficial. This is a community project and is not affiliated with or endorsed by OpenAI. See the disclaimer.
Overview
The OpenAI Ads API exposes an advertiser's account, campaigns, ad groups, ads, and reporting. This server wraps the read endpoints of that API as MCP tools so an AI assistant can answer questions like:
- "Is my OpenAI Ads API key working? What account is it tied to?"
- "List my active campaigns and their budgets."
- "Show spend, clicks, and CTR for campaign
cmp_123over the last 30 days, by day." - "Which ads in ad group
adg_456are still pending review?"
Features
- 11 read-only tools covering the account, campaigns, ad groups, ads, and insights at every level.
- Faithful responses — the API's JSON is returned as-is, so nothing is lost in translation.
- Clear errors — HTTP status and the API error body are surfaced to the model instead