Is this the official X Ads MCP server?

No. X offers its own X Ads MCP server. InsightfulPipe is an independent, hosted MCP server that connects to the X Ads API. InsightfulPipe is not affiliated with X Corp.

How is it different from X's official X Ads MCP?

X's server offers 23 tools and uses your own OAuth 2.0 token, which needs an X developer app with Ads API access. InsightfulPipe needs only an X sign-in, offers a wider set of X Ads actions such as cards, scheduled promoted posts, tracking tags and async analytics, connects X together with 40+ other MCP servers, and adds per-account action controls, Read-only connections and team access.

Which AI assistants does it work with?

Any AI client that supports remote MCP servers. The setup guide on this page covers Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex. You can also work with the same connected ads accounts from the terminal with the InsightfulPipe CLI.

Is there a Claude connector for X Ads?

Yes. In Claude, add https://x-ads.insightfulmcp.com/ as a custom connector and authorize your InsightfulPipe account. You can also add InsightfulPipe from the Claude Directory, which connects all of your linked accounts at once.

Can I use the X Ads MCP server with ChatGPT?

Yes. Add the server URL as a custom connector in ChatGPT Developer mode, or add InsightfulPipe from the ChatGPT app directory to connect all of your linked accounts. Developer mode availability depends on your ChatGPT plan.

What X Ads data can my AI access?

Campaigns, line items, promoted posts, promoted accounts, cards, media, targeting criteria, tracking tags, funding instruments and account history, plus analytics such as impressions, engagements, reposts, likes, replies, follows, video views and X Pixel website conversions. Stats can be segmented, for example by conversation topic, age, location or device.

Which X ad formats does it support?

It covers campaigns run through X Ads Manager: promoted posts (image, video and carousel cards), follower campaigns with promoted accounts, and video ads. Reservation products such as Takeovers are not included.

Can it create and change X campaigns?

Yes, on accounts connected with Read & Write access. It can create and update campaigns and line items, create promoted-only posts, promote posts and accounts, create cards, upload media, schedule promoted posts, and add targeting criteria and tracking tags. New campaigns and line items are created paused.

Can I manage multiple X ads accounts?

Yes. When you sign in with X, InsightfulPipe lists the ads accounts you can access and you choose which ones to connect. Each connected ads account counts as one connection on your plan, and team members with restricted access only get read actions on the accounts granted to them.

How does authentication work?

You connect X Ads to InsightfulPipe by signing in with X and choosing Read-only or Read & Write access. Your AI client then signs in to the MCP server with your InsightfulPipe account and receives an InsightfulPipe access token, not your X login. You can disconnect an ads account in InsightfulPipe at any time.

What can't the X Ads MCP server do?

It does not cover reservation products such as Takeovers, custom audience management or funding changes. Synchronous stats are limited to 7 days and 20 entities per request, so longer ranges run as async jobs of up to 90 days, or 45 days when segmented.

How much does the X Ads MCP server cost?

The X Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month with a 7-day free trial. See insightfulpipe.com/pricing for current plans.

X Ads MCPAdvertising80 actions

X Ads MCP Server

Let your AI agents run X Ads for you, safely.

A hosted X Ads MCP server for Claude, ChatGPT, Cursor and CLI agents. Paste one server URL into your AI client to use its 80 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 X Ads.
80 read and write actions. Every X Ads task your agent needs, from reporting to campaign management.
Built for teams. Invite your team and share one connected account.

Start free trial View all 80 actions

Works with

ChatGPT

Claude

Claude Code

Codex

Gemini CLI

Cursor

Mistral

OpenClaw

HermesPerplexityGrokn8nWindsurfVS CodeZed

ChatGPT

connected to X Ads MCP

Online

Actions

Available Actions

80 actions available to automate your X Ads workflows.

80 actions

Read

Cancel Async Job

Cancel a PROCESSING async analytics job.

Write

Create Ad Tweet

Create a promoted-only (nullcast) tweet for use in ad campaigns. This tweet will NOT appear on the organic timeline.

Read

Create Async Job

Create an async analytics job. Max 90 days (non-segmented) or 45 days (segmented).

Write

Create Campaign

Create a new campaign (created in PAUSED status for safety).

Write

Create Card

Create a card (website, app, or carousel) for use in tweets.

Write

Create Line Item

Create a new line item (ad group) under a campaign (created in PAUSED status for safety).

Write

Create Media Creative

Create a media creative and associate it with a line item.

Write

Create Media Library Item

Add a media asset to the account media library. Also creates an account_media entry.

Write

Create Promoted Account

Associate a user account with a line item as a promoted account.

Write

Create Promoted Tweet

Associate tweets with a line item as promoted tweets.

Write

Create Scheduled Promoted Tweet

Associate a scheduled tweet with a line item as a scheduled promoted tweet.

Write

Create Scheduled Tweet

Create a scheduled tweet for future publishing. Defaults to promoted-only (nullcast).

Write

Create Targeting Criterion

Create a targeting criterion for a line item.

Write

Create Tracking Tag

Create a tracking tag for a line item.

Write

Delete Campaign

Delete a campaign.

Write

Delete Card

Delete a card.

Write

Delete Line Item

Delete a line item.

Write

Delete Media Creative

Delete a media creative.

Write

Delete Promoted Account

Remove a promoted account association.

Write

Delete Promoted Tweet

Remove a promoted tweet association.

Write

Delete Scheduled Promoted Tweet

Remove a scheduled promoted tweet association.

Write

Delete Scheduled Tweet

Delete a scheduled tweet.

Write

Delete Targeting Criterion

Delete a targeting criterion.

Write

Delete Tracking Tag

Delete a tracking tag.

Read

Get Account

Get details for a specific ad account.

Read

Get Account History

Retrieve a summary of changes made to a specific entity on the account.

Read

Get Account Media

List account media assets associated with the current account.

Read

Get Account Media Item

Get details for a specific account media object.

Read

Get Active Entities

Get active entities (campaigns, line items, etc.) that had activity in a time range.

Read

Get Advertiser Business Categories

Retrieve valid advertiser business categories for line items.

Read

Get Async Jobs

Retrieve details for async analytics jobs. Check job status before downloading results.

Read

Get Authenticated User Access

Retrieve the permissions of the authenticated user for the current account.

Read

Get Campaign

Get details for a specific campaign.

Read

Get Campaigns

List all campaigns for an ad account.

Read

Get Card

Get details for a specific card.

Read

Get Cards

List cards associated with the current account.

Read

Get Content Categories

Retrieve content categories for preroll video targeting.

Read

Get Features

Retrieve features enabled for the current account.

Read

Get Funding Instrument

Get details for a specific funding instrument.

Read

Get Funding Instruments

List all funding instruments for an ad account.

Read

Get Iab Categories

Retrieve IAB content categories.

Read

Get Line Item

Get details for a specific line item.

Read

Get Line Items

List all line items for an ad account.

Read

Get Media Creative

Get details for a specific media creative.

Read

Get Media Creatives

List all media creatives for an ad account.

Read

Get Media Library

List media library objects associated with the current account.

Read

Get Media Library Item

Get details for a specific media library object.

Read

Get Promotable User

Get details for a specific promotable user.

Read

Get Promotable Users

List promotable users associated with the current account.

Read

Get Promoted Account

Get details for a specific promoted account.

Read

Get Promoted Accounts

List promoted accounts associated with line items under the current account.

Read

Get Promoted Tweet

Get details for a specific promoted tweet.

Read

Get Promoted Tweets

List promoted tweets associated with line items under the current account.

Read

Get Recommendations

Retrieve campaign optimization recommendations for the account.

Read

Get Scheduled Promoted Tweet

Get details for a specific scheduled promoted tweet.

Read

Get Scheduled Promoted Tweets

List scheduled promoted tweets associated with the current account.

Read

Get Stats

Retrieve synchronous analytics for an ad account. Max 7 days time range.

Read

Get Targeting App Store Categories

Discover available app store category-based targeting criteria.

Read

Get Targeting Conversations

Discover available conversation-based targeting criteria.

Read

Get Targeting Criteria

List targeting criteria associated with line items under the current account.

Read

Get Targeting Criterion

Get details for a specific targeting criterion.

Read

Get Targeting Devices

Discover available device-based targeting criteria.

Read

Get Targeting Events

Discover available event-based targeting criteria.

Read

Get Targeting Interests

Discover available interest-based targeting criteria.

Read

Get Targeting Languages

Discover available language targeting criteria.

Read

Get Targeting Locations

Discover available location-based targeting criteria (countries, regions, cities, postal codes, metros).

Read

Get Targeting Network Operators

Discover available network operator (carrier) targeting criteria.

Read

Get Targeting Platform Versions

Discover available mobile OS version-based targeting criteria.

Read

Get Targeting Platforms

Discover available platform-based targeting criteria (iOS, Android, etc.).

Read

Get Targeting Suggestions

Get keyword or user targeting suggestions to complement your targeting selection.

Read

Get Targeting Tv Markets

Discover available TV markets where TV shows can be targeted.

Read

Get Targeting Tv Shows

Discover available TV show-based targeting criteria.

Read

Get Tax Settings

Retrieve tax setting details for the current account.

Read

Get Tracking Tag

Get details for a specific tracking tag.

Read

Get Tracking Tags

List tracking tags associated with the current account.

Write

Update Campaign

Update an existing campaign.

Write

Update Line Item

Update an existing line item.

Write

Update Media Library Item

Update a media library object's metadata.

Write

Update Tracking Tag

Update an existing tracking tag.

Write

Upload Media

Upload an image for use in ads. Pass image_url (public HTTPS) or media_data (base64). Returns media_id to use with create_media_library_item.

Compare

X Ads MCP servers compared: hosted vs official

X offers its own hosted X Ads MCP server. It is a good fit if you already have an X developer app with Ads API access and want X's core ads tools. InsightfulPipe is a hosted alternative for teams that want quick setup, a wider X Ads action set and account-level controls.

What you operate	InsightfulPipe MCP server	X Ads MCP (X)
Hosting	Hosted by InsightfulPipe: paste one URL	Hosted by X at ads-api.x.com/mcp
Setup	Sign in with X and choose ads accounts	X developer app with Ads API access and an OAuth 2.0 client ID; the agent uses your own OAuth 2.0 token
Tools	80 actions: 53 read and 27 write, including cards, scheduled promoted posts, tracking tags and async analytics	23 tools: 9 account and inventory reads, 2 analytics, 2 targeting lookups and 10 writes
Write safety	Campaigns and line items created paused, ad posts promoted-only, delete actions off by default, per-account action controls	Campaigns and line items are created paused
Documented clients	Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex, plus a CLI	Grok, Claude Code and custom agents
Other platforms	Google Ads, Meta Ads, GA4 and 40+ more MCP servers	X Ads only
Price	Included in plans from $29.99/month, with a 7-day free trial	No price listed in X's documentation

Overview

What you can do with the X Ads MCP

The InsightfulPipe X Ads MCP server is a hosted Model Context Protocol server that connects your X ads accounts to AI assistants such as Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex. You sign in with X, choose the ads accounts to connect and paste one server URL into your AI client.

Claude

Acme StoreRead-only

Ask about your X Ads account…

01Report on campaign performance

Report on campaign performance

Ask for impressions, engagements, clicks, spend and conversions by campaign or line item and get a plain-English summary.

See all X Ads actions

Claude

Acme StoreRead-only

Ask about your X Ads account…

02Find your best promoted posts

Find your best promoted posts

Compare promoted posts by engagement rate, reposts, replies and link clicks to see which messages work.

See all X Ads actions

Claude

Acme StoreRead-only

Ask about your X Ads account…

03Research targeting

Research targeting

Look up interests, conversation topics, events, locations and TV shows, and get keyword and handle suggestions for a line item.

See all X Ads actions

actions

one server URL

read actions

reports, audits, research

write actions

create, update, manage

Setup

How to connect the X 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://x-ads.insightfulmcp.com/

Connect X 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 X Ads only, follow the steps below.

Open Claude Directory

Or add the X Ads server manually:

01
Copy the server URL:
```
https://x-ads.insightfulmcp.com/
```
02
Open Claude connector settings (Customize > Connectors), click + and then Add custom connector.
03
Paste the URL and click Add.
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.

Connect X Ads to ChatGPT

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 X Ads only, follow the steps below.

Open in ChatGPT

Or add the X 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.

01
Copy the server URL:
```
https://x-ads.insightfulmcp.com/
```
02
In ChatGPT, open Settings → Security and login and turn on Developer mode.
03
Go to ChatGPT Plugins and select the + button.
04
Enter a name, paste the URL under Connection and create the connection.
05
When the sign-in opens, click Authorize access in the browser.
06
In a new chat, choose Developer mode from the + menu and select the app. Select it again in each new chat.

See OpenAI's Developer mode guide.

Connect X Ads to Claude Code

Add the server:

claude mcp add --transport http x-ads-mcp https://x-ads.insightfulmcp.com/

02
In Claude Code, run /mcp, select x-ads-mcp and choose Authenticate.
03
Sign in to InsightfulPipe in the browser window and click Authorize access.

Connect X Ads to Cursor

01
Add the X Ads MCP server to Cursor, or add it to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
```
{
  "mcpServers": {
    "x-ads-mcp": {
      "url": "https://x-ads.insightfulmcp.com/"
    }
  }
}
```
02
The server shows Needs authentication. Click Connect, then Open.
03
Sign in to InsightfulPipe and click Authorize access.

Connect X Ads to Gemini CLI

Add the server:

gemini mcp add --transport http x-ads-mcp https://x-ads.insightfulmcp.com/

02
In Gemini CLI, run /mcp auth x-ads-mcp.
03
Sign in to InsightfulPipe in the browser window and click Authorize access.

Connect X Ads to Codex CLI

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.

Open the app listing

01
Add the server. When Codex detects OAuth support, it starts sign-in right away:
```
codex mcp add x-ads-mcp --url https://x-ads.insightfulmcp.com/
```
02
A browser window opens. Sign in to InsightfulPipe and click Authorize access. If no browser opens, run codex mcp login x-ads-mcp.

Watch the setup tutorial

Works everywhere

Bring X Ads into the AI tools you already use

One hosted server URL, any MCP-compatible client. Pick yours to see the setup steps, or paste the URL into anything that speaks MCP.

Playbook

Prompts and skills that run on the X 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 over the last 7 days on spend, engagements and link clicks?”

Uses synchronous stats for campaigns

View prompt

Skill

Social Ads Budget Allocator

Claude skill that compares efficiency across Meta, TikTok, LinkedIn, Pinterest, X and Snapchat ads and recommends how to reallocate social budget.

Download View skill

Prompt

“Which promoted posts got the most reposts and replies this week?”

Compares promoted post engagement

View prompt

Prompt

“Break down last month's impressions by age and location”

Runs a segmented async analytics job

View prompt

Prompt

“Find interest and conversation targeting options related to running”

Searches X targeting criteria

View prompt

Prompt

“Which line items had website purchases from the X Pixel last week?”

Reads web conversion metrics

View prompt

Prompt

“Create a paused Engagements campaign with one line item and a promoted-only post”

Builds the campaign paused for review

View prompt

Prompt

“Show the recent changes made to this ads account”

Reads account history

View prompt

Browse the prompt library All Claude skills

HAVE QUESTIONS?

Frequently asked questions

An X Ads MCP server connects X Ads (formerly Twitter 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 about campaign performance and ask it to make changes, instead of working through X Ads Manager.

You control the risk. New campaigns and line items start paused, and ad posts are created as promoted-only. You can connect accounts as Read-only, and on Read & Write accounts owners, admins and operators choose exactly which actions your AI can use; disabled actions are hidden and blocked. Delete actions stay off by default. Campaign and line item updates can set them to active, and scheduled posts can be switched to organic, so turn those actions off where agents should not launch or publish.