ChatGPT Ads
ChatGPT Ads reporting and paused campaign setup from an MCP client
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- 2 days ago
About ChatGPT Ads
ChatGPT Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
OpenAI's ad platform has its own Ads Management API, and this server wraps it for assistants. Each API key is scoped to one ad account, and the server only ever uses that account's adacct_ ID. The key comes from Settings, then API Keys in OpenAI Ads Manager, and is separate from an OpenAI Platform key.
Reports cover spend, impressions, clicks and CTR by campaign, ad group or ad, with breakdowns by country, device or platform and a chosen attribution window. A separate conversion report shows which countries drive a campaign's results, and another explains why an ad is not serving.
The local npm package lists 30 read tools and 28 write tools. Writes are off by default, preview before applying, and activation, which can spend budget, needs its own switch. The hosted version adds a cockpit, a gallery of chat card images and daily trends.
Install
Run in a terminal
claude mcp add chatgpt-ads --env OPENAI_ADS_API_KEY='<OPENAI_ADS_API_KEY>' --env OPENAI_ADS_ACCOUNT_ID='<OPENAI_ADS_ACCOUNT_ID>' -- npx -y @getmcpads/chatgpt-ads-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"chatgpt-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"chatgpt-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"chatgpt-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"chatgpt-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"chatgpt-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/chatgpt-ads-mcp-server"
],
"env": {
"OPENAI_ADS_API_KEY": "<OPENAI_ADS_API_KEY>",
"OPENAI_ADS_ACCOUNT_ID": "<OPENAI_ADS_ACCOUNT_ID>"
}
}
}
}Configuration
OPENAI_ADS_API_KEYAdvertiser API key from Ads Manager settings. Scoped to one ad account. Keep it secret.RequiredOPENAI_ADS_ACCOUNT_IDThe adacct_ ID the key belongs to. The only account the server will use.RequiredOPENAI_ADS_ENABLE_WRITEStrue exposes the write tools. Defaults to false. Writes preview before applying.OPENAI_ADS_ENABLE_ACTIVATIONtrue allows activation, which can spend budget. Requires writes. Defaults to false.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- openai_ads_get_account
- Fetches the ad account; the README says to call it first.
- openai_ads_get_insights
- Reports spend, impressions, clicks and CTR by campaign, ad group or ad.
- openai_ads_get_conversion_insights
- Shows conversions by country for a campaign or chat card.
What it does
- Insight reports
- Returns spend, impressions, clicks and CTR with breakdowns and attribution windows.
- Conversions by country
- Shows which countries drive a campaign's or chat card's conversions.
- Serving diagnosis
- Reports why an ad is not serving.
- Paused campaign creation
- Creates campaigns, ad groups and chat card ads paused; turning them on is a separate approved step.
- Opt-in writes
- Write tools are disabled by default and preview changes before applying them.
- Activation guard
- Activation needs its own setting on top of writes, since it can spend budget.
Good for
- Report last week's spend and CTR by device
- Check conversions on a 7-day click, 1-day view window
- Find out why a chat card ad is not serving
- Draft a new campaign that stays paused until approved
Pricing
Freemium, from $39 a month
Hosted: free for 1 account, Pro $39/mo, Team $99/mo; local npm package is free
Prices change. Check getmcpads.com before you buy.
ChatGPT Ads FAQ
How do I connect it?
Create an Ads Management API key in OpenAI Ads Manager, then set OPENAI_ADS_API_KEY and OPENAI_ADS_ACCOUNT_ID, or paste the key into the hosted service.
Can it spend my budget?
Only if you set OPENAI_ADS_ENABLE_WRITES and OPENAI_ADS_ENABLE_ACTIVATION to true. Both default to off.
Which accounts can it see?
Only the single ad account the key belongs to.
What does hosting cost?
The hosted service has a free plan for one ad account, Pro at $39 a month and Team at $99 a month.
Is ChatGPT Ads free?
ChatGPT Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.
How do I add ChatGPT Ads to Claude Code?
Run this command in your terminal: claude mcp add chatgpt-ads --env OPENAI_ADS_API_KEY='<OPENAI_ADS_API_KEY>' --env OPENAI_ADS_ACCOUNT_ID='<OPENAI_ADS_ACCOUNT_ID>' -- npx -y @getmcpads/chatgpt-ads-mcp-server
What are the best alternatives to ChatGPT Ads?
The closest alternatives to ChatGPT Ads are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.
Alternatives to ChatGPT Ads

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data