Skip to content

See where you stand

Change it

Works withWordPressShopifyWebflowGitHubGoogleSlackAll integrations
FixesFixes now ship to WordPress, Shopify, Webflow and GitHub

By team

By goal

Done for you

Not sure where to start? Take a guided tour.Book a demo
Customer storyHow the voice AI company Futuro grew its traffic3×AI traffic in 60 days

Learn

Data and research

FreeAI Site GraderAI Query Scannerllms.txt GeneratorAll free tools
Open dataWhere AI sends people, across more than 6,000 sites

OpenAI Ads.
In your assistant.

The open-source MCP server for OpenAI Ads, ChatGPT Ads and the OpenAI Advertiser API. Read performance and manage campaigns in plain English.

Choose your install Read the source

Independent Trakkr project · MIT · v0.1.7

Install openai-ads-mcp
npx
export OPENAI_ADS_API_KEY="sk-ads-your-key"
export OPENAI_ADS_MCP_READONLY=1
npx -y openai-ads-mcp

Node 18+. Remove OPENAI_ADS_MCP_READONLY only when you want write tools visible.

Replace the example key with your own. Keep keys out of shared config files.

Built for the
Advertiser API.

This independent server connects to the OpenAI Advertiser API at api.ads.openai.com/v1.

Package
openai-ads-mcp
Version
0.1.7
Runtime
Python and Node
Transport
stdio and Streamable HTTP
Auth
OpenAI Ads API key, per request or env
Registry
io.github.trakkr-aisearch/openai-ads-mcp
License
MIT

From account
to campaign.

27 tools across 8 groups. Read accounts and insights, prepare context hints, or enable writes in your local setup.

Account

1 tool
  • get_account

Campaigns

5 tools
  • list_campaigns
  • get_campaign
  • create_campaignWrite
  • update_campaignWrite
  • set_campaign_stateWrite

Ad groups

5 tools
  • list_ad_groups
  • get_ad_group
  • create_ad_groupWrite
  • update_ad_groupWrite
  • set_ad_group_stateWrite

Ads

6 tools
  • list_ads
  • get_ad
  • upload_creativeWrite
  • create_adWrite
  • update_adWrite
  • set_ad_stateWrite

Insights

1 tool
  • get_insights

Audiences

4 tools
  • list_audiences
  • get_audience
  • search_geo
  • manage_audienceWrite

Conversions

2 tools
  • manage_conversionsWrite
  • send_conversionsWrite

Workflows

3 tools
  • build_campaignWrite
  • draft_context_hints
  • bulk_ab_test_hintsWrite

Write labels mark tools with mutating actions. In read-only mode, write tools are hidden and mixed tools expose only their read actions. Creating paused applies to new campaigns, ad groups and ads.

Start with the evidence.

Read account data and insights first. Enable local writes deliberately when you’re ready to manage campaigns.

Start with reads

The hosted endpoint is read-only. The local snippets enable read-only mode, hiding write tools and limiting mixed tools to read actions.

OPENAI_ADS_MCP_READONLY=1

Create paused. Set a ceiling.

New campaigns, ad groups and ads are created paused. Budget-setting tools reject values above your ceiling unless confirm_budget is true.

OPENAI_ADS_BUDGET_CEILING_USD=100

Use your own API key

Supply an OpenAI Ads API key per request or through the local environment. The server does not store or log API keys.

X-OpenAI-Ads-API-Key

Choose how
it runs.

Use the hosted endpoint for reads, or run the package locally to control its configuration and write access.

CapabilityHosted endpointLocal package
APIOpenAI Advertiser APIOpenAI Advertiser API
TransportStreamable HTTPstdio or Streamable HTTP
AuthenticationPer-request key headerEnvironment or per-request key
Write toolsRead-onlyOpt in through configuration
New campaigns, ad groups and adsRead-onlyCreated paused
Budget ceilingRead-onlyDefault $100, configurable
Source and licensePublic source, MITPublic source, MIT

This package targets the OpenAI Advertiser API. Check its source and API coverage before using it with your account.

Connect ads
with visibility.

Review campaign data alongside the places AI answers mention, recommend and cite your brand.

Track your brand across AI models

See how ChatGPT, Gemini, and Claude rank you against competitors.

Trakkr MCP server

Pull your live AI visibility data into Claude, ChatGPT, and Cursor.

ChatGPT Ads Context Hint Generator

Draft OpenAI Ads context hints for the moments you are losing.

Free AI visibility tools

Audit your site and benchmark your brand, no signup needed.

Questions,
answered.

The ones we hear most. Need a hand?
Talk to our team

It is an open-source Model Context Protocol server that connects any MCP client, like Claude, Cursor, or Codex, to the OpenAI Advertiser API. Once connected, you can read accounts and insights and manage OpenAI Ads and ChatGPT Ads campaigns in plain English. It ships as the openai-ads-mcp package on npm and PyPI under an MIT license.

Ask anything elseAsk anything else

The Agent answers from our docs, methods and pricing, and links to the source.

Open source.
Ready to inspect.

Choose an install, read the code and connect your own OpenAI Ads account to the assistant you use.

View on GitHub See the Trakkr MCP