Log inSubmit server
Openai Ads MCP logo

Openai Ads MCP

Read-only MCP access to OpenAI Ads campaigns, ad groups, ads, and performance insights.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Openai Ads MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "openai-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypd-ai/openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

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

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

The openai-ads-mcp MCP server exposes OpenAI Ads advertiser data through read-only MCP tools. It uses an OpenAI Ads API key from the environment and communicates with MCP clients over stdio. The tools cover account connectivity, campaign structure, ad details, and performance reporting with filtering and cursor pagination. Reach for it when an agent needs to inspect advertising data without creating, editing, pausing, or deleting resources.

Use cases

  • Check whether an OpenAI Ads API key reaches the expected ad account
  • List campaigns and review budgets or country targeting
  • Inspect ads and identify creatives pending review
  • Compare campaign, ad-group, or ad performance over a date range

Key features

  • Read-only OpenAI Ads account and campaign access
  • Ad-group and ad inspection with optional parent filters
  • Account-, campaign-, ad-group-, and ad-level insights
  • Cursor pagination and reporting filters
  • API JSON and error details passed through
  • Micros-aware tool descriptions

Tools11

What Openai Ads MCP lets your agent do. Expand a tool for its parameters.

Self-reported~168 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

25/25 checks healthy over the last 95d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @hypd-ai/openai-ads-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads314Package downloads in the last 30 days.
Last commit20d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed11Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Openai Ads MCP works

What openai-ads-mcp MCP server does

The openai-ads-mcp MCP server provides an MCP interface to the read endpoints of the OpenAI Ads Advertiser API. It lets compatible AI clients retrieve an ad account, inspect campaign and ad hierarchy, and request reporting data without building direct API calls into the client.

The server is read-only. Its tools do not create campaigns, modify targeting or bids, change ads, pause delivery, delete resources, or spend budget. Each tool is annotated as read-only for clients that use MCP tool hints.

Responses preserve the API's JSON structure. HTTP status codes and API error bodies are passed through to the model instead of being hidden, which can help identify invalid IDs, authentication problems, or other API failures.

How it works

An MCP client launches the server as a local subprocess and supplies the API credential through OPENAI_ADS_API_KEY. The server sends authenticated requests to the OpenAI Ads API using that key. Each key is scoped to one ad account, so the account returned by get_ad_account also serves as a basic connectivity and credential check.

The openai-ads-mcp MCP server supports clients that speak MCP over stdio. The README provides configurations for Claude Desktop, Cursor, and VS Code, and notes that other stdio-compatible clients can run the same command. The default API endpoint is https://api.ads.openai.com/v1; OPENAI_ADS_BASE_URL can override it for testing or a proxy.

Insights requests accept reporting dates in YYYY-MM-DD format. They can use daily or non-granular results, selected fields, sorting, filters, aggregation settings, result limits, and after or before cursors.

Setup and configuration

Use Node.js 20 or newer and create an OpenAI Ads account and API key. Configure the server with:

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

The package is published as @hypd-ai/openai-ads-mcp, so no repository clone or local build is needed for the released version. For source-based use, the project documents cloning the repository, running npm install, building with npm run build, and launching dist/index.js with Node.

Tools and capabilities

The openai-ads-mcp MCP server includes 11 tools:

  • Retrieve the configured ad account.
  • List campaigns and fetch an individual campaign.
  • List ad groups, optionally filtered by campaign, and fetch one by ID.
  • List ads, optionally filtered by ad group, and fetch one by ID.
  • Retrieve account-, campaign-, ad-group-, or ad-level insights.

Campaign results can include objectives, budgets, and country targeting. Ad-group results can include bidding configuration and context hints. Individual ad results can include creative data and review status.

Values ending in _micros, such as spend limits and maximum bids, use one million micros per currency unit. Insights values such as spend, cpc, and cpm are reported as currency decimals rather than micros.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Openai Ads MCP

Run it through Node.js 20 or newer with `npx -y @hypd-ai/openai-ads-mcp`, and set the `OPENAI_ADS_API_KEY` environment variable.

Yes. Add the documented stdio configuration using `npx`, the `@hypd-ai/openai-ads-mcp` package, and `OPENAI_ADS_API_KEY`, then restart Claude Desktop.

It provides tools for the ad account, campaigns, ad groups, ads, and insights at account, campaign, ad-group, and ad levels.

No. The release only registers read tools and cannot create, edit, pause, delete, or otherwise spend budget.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOpenai Ads MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openai-ads-mcp?style=directory)](https://allmcps.com/mcp/openai-ads-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/openai-ads-mcp"><img src="https://allmcps.com/api/badge/openai-ads-mcp?style=directory" alt="Openai Ads MCP on AllMCPs" /></a>