OpenAI Ads
OpenAI Ads MCPAdvertising49 actions

OpenAI Ads MCP Server

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.

Works with
ChatGPTChatGPTClaudeClaudeClaude CodeClaude CodeCodexCodexGemini CLIGemini CLICursorCursorMistralMistralOpenClawOpenClawHermesHermesPerplexityGrokn8nWindsurfVS CodeZed
ChatGPT
OpenAI Ads
ChatGPT
connected to OpenAI Ads MCP
Online
ChatGPT
Actions

Available Actions

49 actions available to automate your OpenAI Ads workflows.

49 actions

OpenAI Ads
Write

Add Custom Audience Identifiers

Add inline identifiers to an existing custom audience.

OpenAI Ads
Write

Archive Custom Audience

Archive a custom audience so it can no longer be used for targeting.

OpenAI Ads
Write

Archive Lead Form

Archive a lead form that is not attached to a published ad.

OpenAI Ads
Write

Create Ad

Create an ad (always created in paused status for safety).

OpenAI Ads
Write

Create Ad Group

Create an ad group (always created in paused status for safety).

OpenAI Ads
Write

Create Bulk Job

Submit an async bulk mutation job (up to 1,000 campaign/ad group/ad operations).

OpenAI Ads
Write

Create Campaign

Create a campaign (always created in paused status for safety).

OpenAI Ads
Write

Create Custom Audience

Create an empty custom audience to fill with add_custom_audience_identifiers.

OpenAI Ads
Write

Create Event Setting

Create a conversion event setting bound to one conversion source.

OpenAI Ads
Write

Create Lead Form

Create a draft lead form.

OpenAI Ads
Write

Create Pixel

Create a web pixel conversion source; returns the source id and the pixel_id for the JavaScript tag.

OpenAI Ads
Read

Get Ad

Get details for a specific ad, including creative and review_status.

OpenAI Ads
Read

Get Ad Account

Get metadata for the connected ad account (name, url, status, timezone, currency, brand review status).

OpenAI Ads
Read

Get Ad Account Insights

Get performance insights for the whole ad account.

OpenAI Ads
Read

Get Ad Group

Get details for a specific ad group.

OpenAI Ads
Read

Get Ad Group Insights

Get performance insights for an ad group.

OpenAI Ads
Read

Get Ad Groups

List ad groups for a campaign.

OpenAI Ads
Read

Get Ad Insights

Get performance insights for a single ad.

OpenAI Ads
Read

Get Ads

List ads for an ad group.

OpenAI Ads
Read

Get Bulk Job

Get the status of a bulk mutation job.

OpenAI Ads
Read

Get Bulk Job Operations

List per-operation results for a bulk mutation job.

OpenAI Ads
Read

Get Campaign

Get details for a specific campaign.

OpenAI Ads
Read

Get Campaign Insights

Get performance insights for a campaign.

OpenAI Ads
Read

Get Campaigns

List campaigns for the ad account.

OpenAI Ads
Read

Get Conversion Events

List conversion events one pixel has received.

OpenAI Ads
Read

Get Conversion Insights

Get conversion metrics (click-through and view-through) per entity.

OpenAI Ads
Read

Get Custom Audience

Get details for a specific custom audience.

OpenAI Ads
Read

Get Custom Audience Operation

Get the privacy-safe lifecycle state of one audience mutation operation.

OpenAI Ads
Read

Get Custom Audiences

List custom audiences for the ad account.

OpenAI Ads
Read

Get Event Settings

List conversion event settings for the ad account.

OpenAI Ads
Read

Get Lead Form

Get details for a specific lead form.

OpenAI Ads
Read

Get Lead Forms

List lead forms for the ad account.

OpenAI Ads
Read

Get Lead Sync Subscription

Get one lead-sync subscription.

OpenAI Ads
Read

Get Lead Sync Subscriptions

Get the ad account's lead-sync subscription state.

OpenAI Ads
Read

Get Pixels

List web pixel conversion sources; each row carries the pixel_id used by the Conversions API.

OpenAI Ads
Write

Merge Custom Audiences

Create a new independent custom audience containing all members of the given audiences.

OpenAI Ads
Write

Preview Ad

Generate a shareable preview for an ad (the preview link expires after 24 hours).

OpenAI Ads
Write

Publish Lead Form

Publish the lead form's current draft revision.

OpenAI Ads
Write

Remove Custom Audience Identifiers

Remove inline identifiers from an existing custom audience.

OpenAI Ads
Read

Search Geo Locations

Search targetable locations (country, region, DMA) and get the ids used in campaign targeting.

OpenAI Ads
Write

Send Conversion Events

Send server-side conversion events to the Conversions API for one pixel.

OpenAI Ads
Write

Test Lead Form Submission

Queue a synthetic, signed lead-sync webhook test submission for a published lead form.

OpenAI Ads
Write

Update Ad

Update an ad: name, creative, or status (live, paused, archived).

OpenAI Ads
Write

Update Ad Group

Update an ad group: name, description, hints, bidding, product set, or status (live, paused, archived).

OpenAI Ads
Write

Update Brand

Update the ad account's brand metadata (display name and/or favicon). Starts a new brand review.

OpenAI Ads
Write

Update Campaign

Update a campaign: name, description, schedule, budget, targeting, or status (live, paused, archived).

OpenAI Ads
Write

Update Lead Form

Save a new draft revision for a lead form.

OpenAI Ads
Write

Update Product Feed Items

Update availability and titles for existing variants in a linked product feed (delta feed).

OpenAI Ads
Write

Upload File

Upload an image asset from a public URL; returns a file_id for ad creatives or the account favicon.

Overview

What you can do with the OpenAI Ads MCP

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.

ClaudeOpenAI AdsAcme StoreRead-only
Ask about your OpenAI Ads account…
01Report on ads in ChatGPT

Report on ads in ChatGPT

Ask for impressions, clicks, spend, CTR and CPC by campaign, ad group or ad and get a plain-English summary.

See all OpenAI Ads actions
ClaudeOpenAI AdsAcme StoreRead-only
Ask about your OpenAI Ads account…
02Measure conversions

Measure conversions

Compare click-through and view-through conversions by campaign and check which conversion events your pixel is receiving.

See all OpenAI Ads actions
ClaudeOpenAI AdsAcme StoreRead-only
Ask about your OpenAI Ads account…
03Build campaigns that start paused

Build campaigns that start paused

Create campaigns, ad groups and ads, or submit a bulk job, and review everything before it goes live.

See all OpenAI Ads actions
49
actions
one server URL
25
read actions
reports, audits, research
24
write actions
create, update, manage
Setup

How to connect the OpenAI Ads MCP server

Add 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.

MCP server URL

https://openai-ads.insightfulmcp.com/

Connect OpenAI Ads to Claude

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.

Open Claude Directory

Or add the OpenAI Ads server manually:

  1. 01
    Copy the server URL:
    https://openai-ads.insightfulmcp.com/
  2. 02
    Open Claude connector settings (Customize > Connectors), click + and then Add custom connector.
  3. 03
    Paste the URL and click Add.
  4. 04
    Click Connect, then click Authorize access in the browser.

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.

Watch the setup tutorial

Playbook

Prompts and skills that run on the OpenAI Ads MCP

Copy a prompt into any connected client, or install a Claude skill that chains the actions for you.

Prompt

“How did my campaigns perform last week on impressions, clicks and spend?”

Pulls campaign insights

Prompt

“Show daily spend and CTR for the account over the last 30 days”

Runs account insights with daily granularity

Prompt

“Which ads are still in review or were rejected?”

Checks ad review status

Prompt

“Compare click-through and view-through conversions by campaign this month”

Reads conversion insights

Prompt

“Create a paused campaign targeting the United States with a $500 lifetime budget”

Looks up the location and builds the campaign paused

Prompt

“Merge my newsletter and past purchaser audiences into one audience”

Creates a merged custom audience

Prompt

“Generate a preview link for our new spring ad”

Creates a shareable ad preview that expires after 24 hours

HAVE QUESTIONS?

Frequently asked questions

An OpenAI Ads MCP server connects OpenAI Ads to AI assistants through the Model Context Protocol (MCP), an open standard for giving AI tools access to data and actions. Once connected, you can ask Claude, ChatGPT or Cursor how your ads in ChatGPT are performing and ask it to make changes, instead of working through OpenAI Ads Manager.

Ready to connect your data?

Join hundreds of agencies and brands using InsightfulPipe to connect marketing data to AI.

Start a trial today.