openai-ads-mcp-server

# OpenAI Ads MCP Server by Insightful Pipe

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://insightfulpipe.com/mcp-servers)
[![Insightful Pipe](https://img.shields.io/badge/Insightful_Pipe-MCP_Servers-purple)](https://insightfulpipe.com/mcp-servers)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

> **Connect OpenAI Ads to AI assistants: campaign management and performance insights for ads in ChatGPT.**

Part of the [Insightful Pipe MCP Server Collection](https://insightfulpipe.com/mcp-servers) — use OpenAI Ads from Claude, ChatGPT, Cursor, and other AI assistants through the Model Context Protocol (MCP).

<img src="images/openai-ads-icon.svg" alt="OpenAI Ads MCP Server" width="64" height="64">

## MCP Server URL

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

## What is OpenAI Ads MCP?

OpenAI Ads MCP is a **remote Model Context Protocol server** hosted by InsightfulPipe. Manage OpenAI Ads campaigns, ad groups, ads, and creatives, and analyze performance insights.

## Installation

### Claude

1. Copy the MCP Server URL: `https://openai-ads.insightfulmcp.com/`
2. Open [Claude Connectors Settings](https://claude.ai/settings/connectors)
3. Scroll to the bottom and click **Add custom connector**
4. Paste the URL and click **Add**
5. Click **Connect** and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.

### ChatGPT

Custom MCP servers are added through ChatGPT's **Developer mode**. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.

1. Turn on **Developer mode** in ChatGPT settings
2. Create a new app for a remote MCP server and paste the URL: `https://openai-ads.insightfulmcp.com/`
3. Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.

See OpenAI's guide: [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

### Claude Code

```bash
claude mcp add --transport http openai-ads https://openai-ads.insightfulmcp.com/
```

### Cursor

Add the server to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "openai-ads": {
      "url": "https://openai-ads.insightfulmcp.com/"
    }
  }
}
```

When Cursor shows **Needs authentication**, click **Connect** and sign in to InsightfulPipe if asked.

## Available Actions

49 actions: 25 read, 24 write.

### Read Actions (25)

| Action | Description |
|--------|-------------|
| `get_ad` | Get details for a specific ad, including creative and review_status |
| `get_ad_account` | Get metadata for the connected ad account (name, url, status, timezone, currency, brand review status) |
| `get_ad_account_insights` | Get performance insights for the whole ad account |
| `get_ad_group` | Get details for a specific ad group |
| `get_ad_group_insights` | Get performance insights for an ad group |
| `get_ad_groups` | List ad groups for a campaign |
| `get_ad_insights` | Get performance insights for a single ad |
| `get_ads` | List ads for an ad group |
| `get_bulk_job` | Get the status of a bulk mutation job |
| `get_bulk_job_operations` | List per-operation results for a bulk mutation job |
| `get_campaign` | Get details for a specific campaign |
| `get_campaign_insights` | Get performance insights for a campaign |
| `get_campaigns` | List campaigns for the ad account |
| `get_conversion_events` | List conversion events one pixel has received |
| `get_conversion_insights` | Get conversion metrics (click-through and view-through) per entity |
| `get_custom_audience` | Get details for a specific custom audience |
| `get_custom_audience_operation` | Get the privacy-safe lifecycle state of one audience mutation operation |
| `get_custom_audiences` | List custom audiences for the ad account |
| `get_event_settings` | List conversion event settings for the ad account |
| `get_lead_form` | Get details for a specific lead form |
| `get_lead_forms` | List lead forms for the ad account |
| `get_lead_sync_subscription` | Get one lead-sync subscription |
| `get_lead_sync_subscriptions` | Get the ad account's lead-sync subscription state |
| `get_pixels` | List web pixel conversion sources; each row carries the pixel_id used by the Conversions API |
| `search_geo_locations` | Search targetable locations (country, region, DMA) and get the ids used in campaign targeting |

### Write Actions (24)

| Action | Description |
|--------|-------------|
| `add_custom_audience_identifiers` | Add inline identifiers to an existing custom audience |
| `archive_custom_audience` | Archive a custom audience so it can no longer be used for targeting |
| `archive_lead_form` | Archive a lead form that is not attached to a published ad |
| `create_ad` | Create an ad (always created in paused status for safety) |
| `create_ad_group` | Create an ad group (always created in paused status for safety) |
| `create_bulk_job` | Submit an async bulk mutation job (up to 1,000 campaign/ad group/ad operations) |
| `create_campaign` | Create a campaign (always created in paused status for safety) |
| `create_custom_audience` | Create an empty custom audience to fill with add_custom_audience_identifiers |
| `create_event_setting` | Create a conversion event setting bound to one conversion source |
| `create_lead_form` | Create a draft lead form |
| `create_pixel` | Create a web pixel conversion source; returns the source id and the pixel_id for the JavaScript tag |
| `merge_custom_audiences` | Create a new independent custom audience containing all members of the given audiences |
| `preview_ad` | Generate a shareable preview for an ad (the preview link expires after 24 hours) |
| `publish_lead_form` | Publish the lead form's current draft revision |
| `remove_custom_audience_identifiers` | Remove inline identifiers from an existing custom audience |
| `send_conversion_events` | Send server-side conversion events to the Conversions API for one pixel |
| `test_lead_form_submission` | Queue a synthetic, signed lead-sync webhook test submission for a published lead form |
| `update_ad` | Update an ad: name, creative, or status (live, paused, archived) |
| `update_ad_group` | Update an ad group: name, description, hints, bidding, product set, or status (live, paused, archived) |
| `update_brand` | Update the ad account's brand metadata (display name and/or favicon) |
| `update_campaign` | Update a campaign: name, description, schedule, budget, targeting, or status (live, paused, archived) |
| `update_lead_form` | Save a new draft revision for a lead form |
| `update_product_feed_items` | Update availability and titles for existing variants in a linked product feed (delta feed) |
| `upload_file` | Upload an image asset from a public URL; returns a file_id for ad creatives or the account favicon |

## Control What Your AI Can Do

You decide what AI agents can do with each connected account:

- **Turn individual actions on or off** for every connected account, so agents only see the actions you allow.
- **Connect as Read-only or Read & Write.** A read-only connection can only enable read actions.
- **Destructive actions stay off by default.** Actions such as deletes are disabled until an admin enables them.
- **Team access per account.** Restricted team members only use the accounts they are granted, with the read actions enabled on them.

## Usage Examples

```
"Show my OpenAI Ads campaign performance for the last 14 days"
```

```
"Which ad groups have the highest click-through rate?"
```

```
"Create a paused campaign for our spring launch"
```

## Pricing

The OpenAI Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month, and you can try it for 7 days. See [insightfulpipe.com/pricing](https://insightfulpipe.com/pricing) for current plans.

## Explore More MCP Servers by Insightful Pipe

Visit **[insightfulpipe.com/mcp-servers](https://insightfulpipe.com/mcp-servers)** to discover our full collection of MCP servers.

- [Google Ads MCP](https://insightfulpipe.com/mcp-servers/google-ads)
- [Meta Ads MCP](https://insightfulpipe.com/mcp-servers/facebook-ads)
- [LinkedIn Ads MCP](https://insightfulpipe.com/mcp-servers/linkedin-ads)
- [TikTok Ads MCP](https://insightfulpipe.com/mcp-servers/tiktok-ads)

**[View All MCP Servers →](https://insightfulpipe.com/mcp-servers)**

## Resources

- [Documentation](https://insightfulpipe.com/docs)
- [Video Tutorial](https://www.youtube.com/playlist?list=PLJNzvjxzI5Xwe__BJJLAelSF0ewO3mEFk)
- [InsightfulPipe Blog](https://insightfulpipe.com/blog)

## Support

- **Documentation**: [insightfulpipe.com/docs](https://insightfulpipe.com/docs)
- **All MCP Servers**: [insightfulpipe.com/mcp-servers](https://insightfulpipe.com/mcp-servers)
- **Email**: support@insightfulpipe.com

---

**[Insightful Pipe](https://insightfulpipe.com)** — AI-powered marketing analytics through MCP servers. [Explore all integrations →](https://insightfulpipe.com/mcp-servers)

## License

MIT License - see [LICENSE](LICENSE) for details.