Openai MCP Server

Read-only MCP server for the OpenAI Ads API: campaigns, ad groups, ads, and insights.

Remote serverstreamable-http

What is the Openai MCP Server?

Read-only MCP server for the OpenAI Ads API: campaigns, ad groups, ads, and insights.

What you get

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.

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:

  • 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 of being swallowed
  • Micros-aware — — every tool description explains the micros convention so the assistant can present human-readable currency
  • Cursor pagination — passthrough (limit, order, after, before)
  • Zero-install — via npx — npx -y @hypd-ai/openai-ads-mcp, no clone or build

Configuration and credentials

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_ad_accountFetch the ad account for the configured key. Great as a connectivity check.
list_campaignsList campaigns (objective, budget, country targeting).
get_campaignFetch a single campaign by ID.
list_ad_groupsList ad groups, optionally filtered by campaign.
get_ad_groupFetch a single ad group by ID (bidding config, context hints).
list_adsList ads, optionally filtered by ad group.
get_adFetch a single ad by ID (creative + review status).
get_account_insightsPerformance insights for the whole account.
get_campaign_insightsPerformance insights for one campaign.
get_ad_group_insightsPerformance insights for one ad group.
get_ad_insightsPerformance insights for one ad.

How to install the Openai MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
OPENAI_ADS_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Openai to get ad account.”
  • “Use Openai to list campaigns.”
  • “Use Openai to get campaign.”

Frequently asked questions

Read-only MCP server for the OpenAI Ads API: campaigns, ad groups, ads, and insights. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.