Add Custom Audience Identifiers
Add inline identifiers to an existing custom audience.
Let your AI agents run OpenAI Ads for you, safely.
A hosted OpenAI Ads MCP server for Claude, ChatGPT, Cursor and CLI agents. Paste one server URL into your AI client to use its 49 actions. There is nothing to install.
Enable or disable every action, per account. Block your agent from doing dangerous actions.
Ask in plain English. Create campaigns, pull reports, find insights and take action in OpenAI Ads.
49 read and write actions. Every OpenAI Ads task your agent needs, from reporting to campaign management.
Built for teams. Invite your team and share one connected account.
49 actions available to automate your OpenAI Ads workflows.
49 actions
Add inline identifiers to an existing custom audience.
Archive a custom audience so it can no longer be used for targeting.
Archive a lead form that is not attached to a published ad.
Create an ad (always created in paused status for safety).
Create an ad group (always created in paused status for safety).
Submit an async bulk mutation job (up to 1,000 campaign/ad group/ad operations).
Create a campaign (always created in paused status for safety).
Create an empty custom audience to fill with add_custom_audience_identifiers.
Create a conversion event setting bound to one conversion source.
Create a draft lead form.
Create a web pixel conversion source; returns the source id and the pixel_id for the JavaScript tag.
Get details for a specific ad, including creative and review_status.
Get metadata for the connected ad account (name, url, status, timezone, currency, brand review status).
Get performance insights for the whole ad account.
Get details for a specific ad group.
Get performance insights for an ad group.
List ad groups for a campaign.
Get performance insights for a single ad.
List ads for an ad group.
Get the status of a bulk mutation job.
List per-operation results for a bulk mutation job.
Get details for a specific campaign.
Get performance insights for a campaign.
List campaigns for the ad account.
List conversion events one pixel has received.
Get conversion metrics (click-through and view-through) per entity.
Get details for a specific custom audience.
Get the privacy-safe lifecycle state of one audience mutation operation.
List custom audiences for the ad account.
List conversion event settings for the ad account.
Get details for a specific lead form.
List lead forms for the ad account.
Get one lead-sync subscription.
Get the ad account's lead-sync subscription state.
List web pixel conversion sources; each row carries the pixel_id used by the Conversions API.
Create a new independent custom audience containing all members of the given audiences.
Generate a shareable preview for an ad (the preview link expires after 24 hours).
Publish the lead form's current draft revision.
Remove inline identifiers from an existing custom audience.
Search targetable locations (country, region, DMA) and get the ids used in campaign targeting.
Send server-side conversion events to the Conversions API for one pixel.
Queue a synthetic, signed lead-sync webhook test submission for a published lead form.
Update an ad: name, creative, or status (live, paused, archived).
Update an ad group: name, description, hints, bidding, product set, or status (live, paused, archived).
Update the ad account's brand metadata (display name and/or favicon). Starts a new brand review.
Update a campaign: name, description, schedule, budget, targeting, or status (live, paused, archived).
Save a new draft revision for a lead form.
Update availability and titles for existing variants in a linked product feed (delta feed).
Upload an image asset from a public URL; returns a file_id for ad creatives or the account favicon.
OpenAI Ads is OpenAI's advertising platform for ads in ChatGPT, managed in OpenAI Ads Manager or through the OpenAI Ads Advertiser API. The InsightfulPipe OpenAI Ads MCP server is a hosted Model Context Protocol server that connects your OpenAI Ads accounts to AI assistants such as Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex.
Ask for impressions, clicks, spend, CTR and CPC by campaign, ad group or ad and get a plain-English summary.
See all OpenAI Ads actionsCompare click-through and view-through conversions by campaign and check which conversion events your pixel is receiving.
See all OpenAI Ads actionsCreate campaigns, ad groups and ads, or submit a bulk job, and review everything before it goes live.
See all OpenAI Ads actionsAdd the server URL to your AI client, then sign in with your InsightfulPipe account to authorize access. The server is hosted, so there is nothing to install.
https://openai-ads.insightfulmcp.com/Fastest: add InsightfulPipe from the Claude Directory
One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to OpenAI Ads only, follow the steps below.
Or add the OpenAI Ads server manually:
https://openai-ads.insightfulmcp.com/
Start a new chat, click +, open Connectors and turn the connector on to use it.
The Free plan can add one custom connector. On Team and Enterprise plans, an Owner first adds it under Organization settings > Connectors, then each member clicks Connect in Customize > Connectors.
Fastest: add InsightfulPipe from the ChatGPT app directory
One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to OpenAI Ads only, follow the steps below.
Or add the OpenAI Ads server manually. Custom MCP servers need ChatGPT's Developer mode, which OpenAI offers on Plus, Pro, Business, Enterprise and Education accounts on the web.
https://openai-ads.insightfulmcp.com/
See OpenAI's Developer mode guide.
claude mcp add --transport http openai-ads-mcp https://openai-ads.insightfulmcp.com/
/mcp, select openai-ads-mcp and choose Authenticate.~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):{
"mcpServers": {
"openai-ads-mcp": {
"url": "https://openai-ads.insightfulmcp.com/"
}
}
}gemini mcp add --transport http openai-ads-mcp https://openai-ads.insightfulmcp.com/
/mcp auth openai-ads-mcp.Using the Codex app? Add InsightfulPipe from the OpenAI app directory
The listed app connects the full InsightfulPipe MCP with all your connected accounts, in both ChatGPT and Codex.
codex mcp add openai-ads-mcp --url https://openai-ads.insightfulmcp.com/
codex mcp login openai-ads-mcp.One hosted server URL, any MCP-compatible client. Pick yours to see the setup steps, or paste the URL into anything that speaks MCP.
Setup guide for ChatGPT
Setup guide for Claude
Setup guide for Claude Code
Setup guide for Codex
Setup guide for Cursor
Setup guide for Gemini CLI
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Paste the server URL to connect
Run actions from your terminal
Copy a prompt into any connected client, or install a Claude skill that chains the actions for you.
“How did my campaigns perform last week on impressions, clicks and spend?”
Pulls campaign insights
“Show daily spend and CTR for the account over the last 30 days”
Runs account insights with daily granularity
“Which ads are still in review or were rejected?”
Checks ad review status
“Compare click-through and view-through conversions by campaign this month”
Reads conversion insights
“Create a paused campaign targeting the United States with a $500 lifetime budget”
Looks up the location and builds the campaign paused
“Merge my newsletter and past purchaser audiences into one audience”
Creates a merged custom audience
“Generate a preview link for our new spring ad”
Creates a shareable ad preview that expires after 24 hours
Join hundreds of agencies and brands using InsightfulPipe to connect marketing data to AI.
Start a trial today.