Openai Ads Mcp
This is a read-only bridge to the OpenAI Ads API that surfaces your campaigns, ad groups, ads, and performance insights through 11 MCP tools. You can ask Claude to check if your API key is working, list active campaigns with their budgets, pull CTR and spend breakdowns for specific date ranges, or see which ads are stuck in review. It handles cursor pagination and surfaces the API's JSON as-is, including those micros fields for budget and bid amounts. The developer flags this as unofficial and community-maintained, with write operations planned but not yet implemented. If you're running OpenAI ad campaigns and want to query them conversationally without building your own dashboard, this slots right into Claude Desktop or Cursor.
- GitHub stars
- 2
- tools
- 11
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Jun 3, 2026
Tools
11 toolsPublic tool metadata for what this MCP can expose to an agent.
get_ad_accountFetch the ad account for the configured key. Great as a connectivity check.
Fetch the ad account for the configured key. Great as a connectivity check.
No parameter schema in public metadata yet.
list_campaignsList campaigns (objective, budget, country targeting).
List campaigns (objective, budget, country targeting).
No parameter schema in public metadata yet.
get_campaignFetch a single campaign by ID.
Fetch a single campaign by ID.
No parameter schema in public metadata yet.
list_ad_groupsList ad groups, optionally filtered by campaign.
List ad groups, optionally filtered by campaign.
No parameter schema in public metadata yet.
get_ad_groupFetch a single ad group by ID (bidding config, context hints).
Fetch a single ad group by ID (bidding config, context hints).
No parameter schema in public metadata yet.
list_adsList ads, optionally filtered by ad group.
List ads, optionally filtered by ad group.
No parameter schema in public metadata yet.
get_adFetch a single ad by ID (creative + review status).
Fetch a single ad by ID (creative + review status).
No parameter schema in public metadata yet.
get_account_insightsPerformance insights for the whole account.
Performance insights for the whole account.
No parameter schema in public metadata yet.
get_campaign_insightsPerformance insights for one campaign.
Performance insights for one campaign.
No parameter schema in public metadata yet.
get_ad_group_insightsPerformance insights for one ad group.
Performance insights for one ad group.
No parameter schema in public metadata yet.
get_ad_insightsPerformance insights for one ad.
Performance insights for one ad.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
OPENAI_ADS_API_KEY*secretOpenAI Ads API key (Bearer token), scoped to one ad account.
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
Details
- Repository
- github.com/hypd-ai/openai-ads-mcp
- Categories
- AI & LLM Tools, Finance & Commerce
- Package
@hypd-ai/openai-ads-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
Llm Advisordaichi-kudo/llm-advisor-mcpReal-time LLM/VLM benchmarks, pricing, and recommendations. 300+ models, 5 sources.2stars
LLM Assurek11-software-solutions/k11techlab-llm-assurance-toolkitRed-team LLM apps: 41 OWASP LLM Top 10 probes, adaptive attacks, CI gate, audit reports.0stars
Memory Mcp Litethuupx/memory-mcp-liteA lightweight, structured, token-efficient local-first MCP memory server2stars
Agent Mosaic Skillable-rip/agent-mosaic-skillConvert photos to LEGO-style brick mosaic previews with AI-powered color quantization.1stars
Impact Previewagent-polis/impact-previewImpact preview for AI agents - see what changes before any action executes.1stars
Agent Moduleagentmodule/mcpDeterministic compliance and vertical knowledge bases for autonomous agents. Free 24hr trial.0stars