X Ads MCP by InsightfulPipe

X Ads MCP Server (Twitter Ads) by Insightful Pipe

Connect X Ads (formerly Twitter Ads) to AI assistants to report on campaigns and build them: campaigns, line items, promoted-only posts and cards, with new campaigns starting paused.

Part of the Insightful Pipe MCP Server Collection — The X Ads MCP server gives Claude, ChatGPT, Cursor and other AI assistants 80 actions (52 read and 28 that make changes) on your X ad accounts. Your assistant can report on campaigns, line items, promoted posts and creatives, then create campaigns, line items, promoted-only ad posts and website, app or carousel cards. New campaigns and line items start paused, ad posts are created promoted-only so they don't appear on your public timeline, and delete actions stay off until an admin turns them on.

For your account's own posts, replies, direct messages and post analytics, use the X Organic MCP server.

MCP Server URL

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

What is X Ads MCP?

X Ads MCP is a remote Model Context Protocol server that connects your X Ads Manager to AI assistants. This real-time advertising integration allows you to:

• Query X ad performance using natural language
• Analyze promoted tweet engagement
• Track video views and website conversions
• Create async analytics jobs for large datasets
• Get AI recommendations for campaign optimization

Installation

Claude

1. Copy the MCP Server URL: https://x-ads.insightfulmcp.com/
2. Open Claude connector settings (Customize > Connectors), click + and then Add custom connector
3. Paste the URL and click Add
4. 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://x-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

Claude Code

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

Cursor

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

{

"mcpServers": { "x-ads": { "url": "https://x-ads.insightfulmcp.com/" } } }

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

Available Actions

80 actions: 52 read and 28 that make changes, 11 of them destructive and off by default.

Read Actions (52)

Show all 52 read actions

Actions That Make Changes (28)

Show all 28 write and destructive actions

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

Campaign Performance

"How are my X ad campaigns performing this week?"

Tweet Analysis

"Which promoted tweets have the highest engagement rate?"

Line Item Performance

"Show me stats for my top performing line items"

Async Reports

"Create an async analytics job for the last 90 days"

Creative Performance

"What creatives are driving the most conversions?"

Supported Metrics

Why X Ads MCP?

For Brand Marketers

• Real-time engagement - Track engagement on promoted posts
• Trending topics - Capitalize on trends
• Brand awareness - Measure reach and engagement

For Performance Marketers

• Conversion tracking - Website and app actions
• Async analytics - Handle large data ranges
• Line item optimization - Granular performance data

For Agencies

• Multi-account management - Handle client portfolios
• **Autom