OpenAI Ads MCP

Trakkr tracks the full AI-visibility funnel, organic and paid. This is the open-source paid-side companion. Its 8 documented tools cluster into create & write, read & search, build, draft.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-22 · ★ 3 · #117 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install OpenAI Ads MCP

before you install - you'll need

Set OPENAI_ADS_API_KEY, OPENAI_ADS_MCP_READONLY, OPENAI_ADS_MCP_HOSTED_PUBLIC, OPENAI_ADS_MCP_TELEMETRY_SALT before connecting. OPENAI_ADS_MCP_HTTP_TOKEN is optional or environment-specific per the README.

Claude Code

claude mcp add trakkr-aisearch-openai-ads-mcp --transport http https://openai-ads-mcp.trakkr.ai/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "trakkr-aisearch-openai-ads-mcp": {
      "url": "https://openai-ads-mcp.trakkr.ai/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

https://openai-ads-mcp.trakkr.ai/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-08-25

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 · remote - your agent's requests go to openai-ads-mcp.trakkr.ai

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license MIT - declared in the repository

npm package openai-ads-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.trakkr-aisearch 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 get the ad account and confirms the API key works, read account, campaign, ad group, or ad insights with fields, filters, sort, segments, and cursor pagination, create a paused campaign with a guarded lifetime budget, including conversion-optimized campaigns with one event setting, and upload an image URL or local image file and return file_id.

Capability map

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

create & write

3 tools - e.g. Creates a paused campaign with a guarded lifetime budget, including conversion-optimized campaigns with one event setting.; Uploads an image URL or local image file and returns file_id.; Creates a paused…

create_campaign · upload_creative · create_ad

read & search

2 tools - e.g. Gets the ad account and confirms the API key works.; Reads account, campaign, ad group, or ad insights with fields, filters, sort, segments, and cursor pagination.

get_account · get_insights

Build

1 tool - e.g. Creates one paused campaign, one paused ad group, and paused ads in a guarded workflow.

build_campaign

Draft

1 tool - e.g. Deterministically drafts API-shaped context_hints with no hidden LLM call.

draft_context_hints

run & execute

1 tool - e.g. Sends conversion events to https://bzr.openai.com/v1/events?pid=... after local validation, with optional validate_only. Supports obref and mobile app lifecycle

send_conversions

Latest releases

openai-ads-mcp-v0.1.5 · 2026-06-20

OpenAI Ads MCP Server v0.1.5 · openai-ads-mcp is the open-source, typed MCP server for OpenAI Ads, ChatGPT Ads, and OpenAI's Advertiser API, maintained by Trakkr. · It gives Claude, Cursor, Codex, VS Code, and other…

openai-ads-mcp-v0.1.4 · 2026-06-20

What's new · Tunes discovery metadata for OpenAI Ads, ChatGPT Ads, and the Advertiser API. · Expands npm and PyPI keywords for MCP directory and AI-search matching. · Updates the MCP Registry description so searches…

openai-ads-mcp-v0.1.3 · 2026-06-20

What's new · Adds official MCP Registry metadata under io.github.trakkr-aisearch/openai-ads-mcp. · Adds npm mcpName and PyPI mcp-name ownership markers. · Adds Streamable HTTP mode for hosted/team deployments: npx -y…

04 · Who maintains OpenAI Ads MCP

OpenAI Ads MCP is maintained by trakkr-aisearch. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository
github.com/trakkr-aisearch/openai-ads-mcp
website
https://trakkr.ai/openai-ads-mcp
category
API integration - ranked #117 of 250 actively-maintained API integration servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-06-20)
registry
io.github.trakkr-aisearch/openai-ads-mcp (active, first published 2026-06-20 · 5 versions)
packages
npm:openai-ads-mcp · pypi:openai-ads-mcp

06 · OpenAI Ads MCP FAQ

Is OpenAI Ads MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-22 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can OpenAI Ads MCP do?

With this server connected, an agent can get the ad account and confirms the API key works, read account, campaign, ad group, or ad insights with fields, filters, sort, segments, and cursor pagination, create a paused campaign with a guarded lifetime budget, including conversion-optimized campaigns with one event setting, and upload an image URL or local image file and return file_id.

How do I install OpenAI Ads MCP?

Run `npx -y openai-ads-mcp`. The README documents 5 environment variables (OPENAI_ADS_API_KEY, OPENAI_ADS_MCP_READONLY, OPENAI_ADS_MCP_HTTP_TOKEN…) to set first. Set OPENAI_ADS_API_KEY, OPENAI_ADS_MCP_READONLY, OPENAI_ADS_MCP_HOSTED_PUBLIC, OPENAI_ADS_MCP_TELEMETRY_SALT before connecting. OPENAI_ADS_MCP_HTTP_TOKEN is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does OpenAI Ads MCP require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-08-25; you can connect without credentials.

07 · Alternatives to OpenAI Ads MCP

Alternatives to OpenAI Ads MCP

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

  1. Microsoft 365 MCP Server Interact with Microsoft 365 and Office services through the Microsoft Graph API. ★ 932 · 2026-08-24
  2. Tapo MCP MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents ★ 796 · 2026-08-21
  3. Idea Reality MCP Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt - returns 0-100 signal. ★ 782 · 2026-08-11
  4. Sqz Pre-injection context compression for coding agents. Zero LLM calls, zero telemetry, offline-safe. ★ 609 · 2026-08-23
  5. Sv Number MCP Server Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. ★ 560 · 2026-08-10
  6. Anytype MCP Official MCP server for Anytype API - your encrypted, local and collaborative wiki. ★ 510 · 2026-08-24

More API integration MCP servers · Transloadit Media Processing · Unulu · Notra · Vaquill · Lviv Public Transport

More TypeScript MCP servers · Contextatlas · Treza · Gitworthy · Brave DevTools MCP · see all