MCP.Market

Openai Ads MCP server

by HYPD-AI·io.github.HYPD-AI/openai-ads-mcp·v0.1.3·5 stars
No reviews yet

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

B74/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B74/100

full report

Adoption
Growing

5 stars64 downloads/wk

Reviews

Write one

Nobody has reviewed Openai Ads yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Openai Ads tools (11)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_account_insights

    Retrieve performance insights aggregated across the entire ad account.

  • get_ad

    Fetch a single ad by its ID, including its creative and review status.

  • get_ad_account

    Fetch the ad account associated with the configured API key. Use this as a connectivity check to confirm the key is valid, and to read account-level details such as name, currency, status, and timezone. Each API key is scoped to a single ad account.

  • get_ad_group

    Fetch a single ad group by its ID, including its status, bidding configuration, and context hints.

  • get_ad_group_insights

    Retrieve performance insights for a single ad group.

  • get_ad_insights

    Retrieve performance insights for a single ad.

  • get_campaign

    Fetch a single campaign by its ID, including its objective, status, budget, and targeting.

  • get_campaign_insights

    Retrieve performance insights for a single campaign.

  • list_ad_groups

    List ad groups within a campaign (`campaign_id` is required). Ad groups belong to a campaign and hold the bidding configuration and context hints. Supports cursor pagination (`order`, `after`/`before`; the response includes `first_id`, `last_id`, and `has_more`).

  • list_ads

    List ads within an ad group (`ad_group_id` is required). Each ad holds a creative (title, body, target URL, image) and a `review_status` (in_review, approved, or rejected). Supports cursor pagination (`order`, `after`/`before`; the response includes `first_id`, `last_id`, and `has_more`).

  • list_campaigns

    List campaigns in the ad account. Campaigns are the top-level objects that define the objective, budget, and country targeting. Supports cursor pagination; the response includes `first_id`, `last_id`, and `has_more`.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 116 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Overall 74/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Openai Ads compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
74/100
higher than 43% of 4,464 AI and agents servers
Tools
11
the typical AI and agents server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
5
more than 78% of 2,697 AI and agents servers
Downloads a week
64
more than 53% of 1,515 AI and agents servers with a package

What its tools let an agent do: 11 read

Install Openai Ads in Claude Code, Cursor or VS Code

Runs npx -y @hypd-ai/openai-ads-mcp on your machine. Read the scan report first; the gateway never runs local packages.

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

What the publisher says

From the Openai Ads repository's README, as published. We do not edit it. Read it on GitHub

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 cmp123 over the last 30 days, by day."_
  • "Which ads in ad group adg456 are 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 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.

Tools

Insights tools accept since/until (YYYY-MM-DD) for the reporting window, plus timegranularity (daily/none), aggregationlevel, fields, sort, filters, limit (1–10000), and after/before cursors.

Prerequisites

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Openai Ads: common questions

Is Openai Ads MCP server safe?
Mostly: it is graded B (74/100). Read the Openai Ads safety report
How do I install Openai Ads?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Openai Ads need an API key?
Yes. The registry entry asks for OPENAI_ADS_API_KEY.
Is Openai Ads maintained?
The last commit was 152 days ago (2026-06-03). The latest release is v0.1.3.
What can I use instead of Openai Ads?
Servers from other publishers that do the same job: freellmpool MCP server.
How does Openai Ads compare with other AI and agents MCP servers?
safety score 74/100 (higher than 43% of 4,464 AI and agents servers); tools 11 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Openai Ads

Same job from other publishers: the closest match first, then the best rated.

  • freellmpool
    OpenAI-compatible MCP gateway cataloging 22 LLM providers, with routing, failover, and tools.
    A