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. Its 11 documented tools cover insights, account, campaign, group. It runs locally over stdio via the published package.

People who work with insights, account and campaign and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-03 · ★ 5 · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install OpenAI Ads MCP

before you install - you'll need

Set OPENAI_ADS_API_KEY before connecting.

Claude Code

claude mcp add hypd-ai-openai-ads-mcp -- npx -y @hypd-ai/openai-ads-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @hypd-ai/openai-ads-mcp - published under the repo owner's npm scope (@hypd-ai)

registry namespace io.github.HYPD-AI is GitHub-verified and matches the repo owner

03 · What OpenAI Ads MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can fetch the ad account for the configured key. Great as a connectivity check, list campaigns (objective, budget, country targeting), fetch a single campaign by ID, and list ad groups, optionally filtered by campaign.

Capability map

Tools grouped from the project's README - what OpenAI Ads MCP lets an agent do.

read & search

5 tools - e.g. List campaigns (objective, budget, country targeting).; List ad groups, optionally filtered by campaign.; List ads, optionally filtered by ad group.

list_campaigns · list_ad_groups · list_ads · get_ad · get_ad_insights

Account

2 tools - e.g. Fetch the ad account for the configured key. Great as a connectivity check.; Performance insights for the whole account.

get_ad_account · get_account_insights

Campaign

2 tools - e.g. Fetch a single campaign by ID.; Performance insights for one campaign.

get_campaign · get_campaign_insights

Group

2 tools - e.g. Fetch a single ad group by ID (bidding config, context hints).; Performance insights for one ad group.

get_ad_group · get_ad_group_insights

Latest releases

v0.1.1 · 2026-06-03

@hypd-ai/openai-ads-mcp v0.1.1 · A Model Context Protocol (MCP) server giving MCP clients (Claude Desktop, Cursor, VS Code, and others) read-only access to the OpenAI Ads (Advertiser) API over stdio. · > Now on npm…

v0.1.0 · 2026-05-29

openai-ads-mcp v0.1.0 · First public release - a Model Context Protocol (MCP) server that gives MCP clients (Claude Desktop, Cursor, VS Code, and others) read-only access to the OpenAI / ChatGPT Ads (Advertiser) API…

04 · Who maintains OpenAI Ads MCP

openai-ads-mcp is maintained by hypd-ai. We track 2 MCP servers from hypd-ai - 2 actively maintained, 7 combined GitHub stars, oldest repo from May 2026. Full record: all servers from hypd-ai.

HYPD AI - Paid Ads & Analytics Google Ads, Meta (Facebook) Ads, GA4 and Merchant Center analysis in plain language. Read-only. ★ 2

05 · Facts

repository: github.com/hypd-ai/openai-ads-mcp
category: API integration - actively maintained as of 2026-09-18.
registry: io.github.HYPD-AI/openai-ads-mcp (active, first published 2026-06-03)
packages: npm:@hypd-ai/openai-ads-mcp

06 · OpenAI Ads MCP FAQ

Is OpenAI Ads MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-06-03. We re-verify nightly.

What can OpenAI Ads MCP do?

How do I install OpenAI Ads MCP?

Run `npx -y @hypd-ai/openai-ads-mcp`. The README documents one environment variable (OPENAI_ADS_API_KEY) to set first. Set OPENAI_ADS_API_KEY before connecting. You can also paste the ready-made client config above.

Does OpenAI Ads MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to OpenAI Ads MCP

Alternatives to OpenAI Ads MCP

Maintained API integration servers if OpenAI Ads MCP isn't the fit.

More API integration MCP servers · CricketStudio MCP · Ictfax MCP · Ictpbx MCP · Честный знак MCP (RU) - коды маркировки, ГИС МТ, СУЗ · Server Zotero Dev

More TypeScript MCP servers · SSH MCP Server (hypnosis) · Server Tauri · Q Ring · Memex (iamtouchskyer) · Wso2 Docs MCP Server · see all