X Ads MCP by InsightfulPipe
com.insightfulpipePublished by insightfulpipe.comv1.0.0Updated Oct 26, 2026
Hosted X Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Overview
Hosted MCP server that connects X Ads (Twitter Ads) accounts to AI assistants for campaign reporting and creation, with per-account action controls.
- What you can do
- Read campaigns, line items, promoted posts, cards, creatives, media, targeting options, tracking tags and funding instruments
- Pull synchronous and async analytics on impressions, engagements, clicks, video views, conversions and recommendations
- Create campaigns, line items, promoted-only ad posts, cards, creatives, targeting criteria and tracking tags
- Update campaigns, line items, media library items and tracking tags, and upload images
- Delete campaigns, cards, line items, creatives, targeting criteria, tracking tags and scheduled tweets when enabled
- When to use it
- Useful for marketers, performance teams and agencies who want to ask an assistant about X ad performance in natural language, generate reports, or draft new campaigns and ad creatives without leaving the chat.
- Requirements
- Remote streamable HTTP endpoint; no local install. Requires OAuth sign-in to InsightfulPipe and an X Ads account, plus a paid InsightfulPipe plan (7-day trial). ChatGPT use needs Developer mode and a plan that allows custom MCP servers.
Installation
In SourceWeft
- Open X Ads MCP by InsightfulPipe in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.insightfulpipe%2Fx-ads/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"x-ads-by-insightfulpipe": {
"type": "http",
"url": "https://x-ads.insightfulmcp.com/"
}
}
}README
X Ads MCP Server (Twitter Ads) by Insightful Pipe
[MCP Compatible] [Insightful Pipe] [License]
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
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
- Copy the MCP Server URL:
https://x-ads.insightfulmcp.com/ - Open Claude connector settings (Customize > Connectors), click + and then Add custom connector
- Paste the URL and click Add
- 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.
- Turn on Developer mode in ChatGPT settings
- Create a new app for a remote MCP server and paste the URL:
https://x-ads.insightfulmcp.com/ - 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
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
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
Tweet Analysis
Line Item Performance
Async Reports
Creative Performance
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
- Automated reporting - Generate engagement reports
Security & Privacy
- X Developer Platform - Official API access
- OAuth 2.0 - Secure X authentication
- Data encryption - Secure transmission
Pricing
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, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.
Ready-Made Skills and Prompts
- Claude skills for social media ads — ready-made skills that run on your connected data
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers for marketing and analytics.
Social Advertising MCP Servers
- Facebook Ads MCP - Social advertising
- TikTok Ads MCP - Video advertising
- LinkedIn Ads MCP - Professional social
- Snapchat Ads MCP - Gen-Z advertising
Search Advertising MCP Servers
- Google Ads MCP - Search advertising
- Microsoft Ads MCP - Bing advertising
Resources
Support
- Documentation: insightfulpipe.com/docs
- All MCP Servers: insightfulpipe.com/mcp-servers
- Email: [email protected]
Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →
License
MIT License - see LICENSE for details.
Source: README.md at commit 82950f2
Tools
0Version history
1- v1.0.0LatestOct 21, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts