ChatGPT Ads — Claude Code MCP server: what it does, how to install
MCP server connecting your AI assistant to the ChatGPT Ads Advertiser API. Helps you inspect campaign metrics, conversion setups, and prepare changes.
claude mcp add --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> --transport stdio chatgpt-ads -- npx -y @getmcpads/chatgpt-ads-mcp-serverWhat ChatGPT Ads does
The package exposes 30 read tools covering ad accounts, campaigns, ad groups, chat card creatives, conversion metrics, custom audiences, and audit logs. Traffic flows directly to api.ads.openai.com via stdio without intermediate proxy layers.
All 28 mutation tools are disabled out of the box. Enabling them requires setting OPENAI_ADS_ENABLE_WRITES to true. Every write enforces a preview step, executing only the confirmed payload. New items stay paused upon creation, and starting actual ad delivery requires setting OPENAI_ADS_ENABLE_ACTIVATION to true.
The server requires an Advertiser API key generated in Ads Manager settings together with an adacct_ account ID. Standard OpenAI Platform API tokens are rejected.
What it helps with
- read advertising performance with device, country, and platform breakdowns
- inspect campaign configurations and custom audiences without opening Ads Manager
- prepare ad changes using confirmed previews before sending updates
Example prompts for the agent
- Check the ad account overview and current status using openai_ads_get_account
- Fetch campaign performance insights and conversion numbers for this week
- Draft a campaign update and generate a preview before saving changes
How to install ChatGPT Ads
Platform CLI
claude mcp add --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> --transport stdio chatgpt-ads -- npx -y @getmcpads/chatgpt-ads-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add chatgpt-ads --env OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> --env OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> --env OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> --env OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> -- npx -y @getmcpads/chatgpt-ads-mcp-serverReplace <…> with your own values
Config file
{
"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>",
"OPENAI_ADS_ENABLE_WRITES": "<OPENAI_ADS_ENABLE_WRITES>",
"OPENAI_ADS_ENABLE_ACTIVATION": "<OPENAI_ADS_ENABLE_ACTIVATION>"
}
}
}
}Replace <…> with your own values
Config file
{
"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>",
"OPENAI_ADS_ENABLE_WRITES": "<OPENAI_ADS_ENABLE_WRITES>",
"OPENAI_ADS_ENABLE_ACTIVATION": "<OPENAI_ADS_ENABLE_ACTIVATION>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> -e OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> -e OPENAI_ADS_ENABLE_WRITES=<OPENAI_ADS_ENABLE_WRITES> -e OPENAI_ADS_ENABLE_ACTIVATION=<OPENAI_ADS_ENABLE_ACTIVATION> chatgpt-ads npx -y @getmcpads/chatgpt-ads-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ChatGPT Ads
How to install ChatGPT Ads in Claude Code?
Run `claude mcp add chatgpt-ads -e OPENAI_ADS_API_KEY=<OPENAI_ADS_API_KEY> -e OPENAI_ADS_ACCOUNT_ID=<OPENAI_ADS_ACCOUNT_ID> -- npx -y @getmcpads/chatgpt-ads-mcp-server`.
What does ChatGPT Ads MCP server do?
It gives your MCP client read access across 30 ad account resources, alongside 28 opt-in modification tools governed by dry-run previews.
What credentials does this MCP server require?
It requires an Advertiser API key from Ads Manager along with the matching adacct_ identifier. Standard OpenAI Platform API keys do not work.
