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

Action	Description
create_async_job	Create an async analytics job
get_account	Get details for a specific ad account
get_account_history	Retrieve a summary of changes made to a specific entity on the account
get_account_media	List account media assets associated with the current account
get_account_media_item	Get details for a specific account media object
get_active_entities	Get active entities (campaigns, line items, etc.) that had activity in a time range
get_advertiser_business_categories	Retrieve valid advertiser business categories for line items
get_async_jobs	Retrieve details for async analytics jobs
get_authenticated_user_access	Retrieve the permissions of the authenticated user for the current account
get_campaign	Get details for a specific campaign
get_campaigns	List all campaigns for an ad account
get_card	Get details for a specific card
get_cards	List cards associated with the current account
get_content_categories	Retrieve content categories for preroll video targeting
get_features	Retrieve features enabled for the current account
get_funding_instrument	Get details for a specific funding instrument
get_funding_instruments	List all funding instruments for an ad account
get_iab_categories	Retrieve IAB content categories
get_line_item	Get details for a specific line item
get_line_items	List all line items for an ad account
get_media_creative	Get details for a specific media creative
get_media_creatives	List all media creatives for an ad account
get_media_library	List media library objects associated with the current account
get_media_library_item	Get details for a specific media library object
get_promotable_user	Get details for a specific promotable user
get_promotable_users	List promotable users associated with the current account
get_promoted_account	Get details for a specific promoted account
get_promoted_accounts	List promoted accounts associated with line items under the current account
get_promoted_tweet	Get details for a specific promoted tweet
get_promoted_tweets	List promoted tweets associated with line items under the current account
get_recommendations	Retrieve campaign optimization recommendations for the account
get_scheduled_promoted_tweet	Get details for a specific scheduled promoted tweet
get_scheduled_promoted_tweets	List scheduled promoted tweets associated with the current account
get_stats	Retrieve synchronous analytics for an ad account
get_targeting_app_store_categories	Discover available app store category-based targeting criteria
get_targeting_conversations	Discover available conversation-based targeting criteria
get_targeting_criteria	List targeting criteria associated with line items under the current account
get_targeting_criterion	Get details for a specific targeting criterion
get_targeting_devices	Discover available device-based targeting criteria
get_targeting_events	Discover available event-based targeting criteria
get_targeting_interests	Discover available interest-based targeting criteria
get_targeting_languages	Discover available language targeting criteria
get_targeting_locations	Discover available location-based targeting criteria (countries, regions, cities, postal codes, metros)
get_targeting_network_operators	Discover available network operator (carrier) targeting criteria
get_targeting_platform_versions	Discover available mobile OS version-based targeting criteria
get_targeting_platforms	Discover available platform-based targeting criteria (iOS, Android, etc.)
get_targeting_suggestions	Get keyword or user targeting suggestions to complement your targeting selection
get_targeting_tv_markets	Discover available TV markets where TV shows can be targeted
get_targeting_tv_shows	Discover available TV show-based targeting criteria
get_tax_settings	Retrieve tax setting details for the current account
get_tracking_tag	Get details for a specific tracking tag
get_tracking_tags	List tracking tags associated with the current account

Actions That Make Changes (28)

Show all 28 write and destructive actions

Action	Description
cancel_async_job	Cancel a PROCESSING async analytics job
create_ad_tweet	Create a promoted-only (nullcast) tweet for use in ad campaigns
create_campaign	Create a new campaign (created in PAUSED status for safety)
create_card	Create a card (website, app, or carousel) for use in tweets
create_line_item	Create a new line item (ad group) under a campaign (created in PAUSED status for safety)
create_media_creative	Create a media creative and associate it with a line item
create_media_library_item	Add a media asset to the account media library
create_promoted_account	Associate a user account with a line item as a promoted account
create_promoted_tweet	Associate tweets with a line item as promoted tweets
create_scheduled_promoted_tweet	Associate a scheduled tweet with a line item as a scheduled promoted tweet
create_scheduled_tweet	Create a scheduled tweet for future publishing
create_targeting_criterion	Create a targeting criterion for a line item
create_tracking_tag	Create a tracking tag for a line item
delete_campaign	Delete a campaign
delete_card	Delete a card
delete_line_item	Delete a line item
delete_media_creative	Delete a media creative
delete_promoted_account	Remove a promoted account association
delete_promoted_tweet	Remove a promoted tweet association
delete_scheduled_promoted_tweet	Remove a scheduled promoted tweet association
delete_scheduled_tweet	Delete a scheduled tweet
delete_targeting_criterion	Delete a targeting criterion
delete_tracking_tag	Delete a tracking tag
update_campaign	Update an existing campaign
update_line_item	Update an existing line item
update_media_library_item	Update a media library object's metadata
update_tracking_tag	Update an existing tracking tag
upload_media	Upload an image for use in ads

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

Metric	Description
Impressions	Total tweet views
Engagements	Likes, retweets, replies, clicks
Engagement Rate	Engagements / impressions
Link Clicks	Clicks to your website
Video Views	Video ad views
Follows	New follower gains
App Installs	Mobile app installations
Cost Per Engagement	Average CPE

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

View All MCP Servers →

Resources

• Documentation
• Video Tutorial
• InsightfulPipe Blog

Support

• Documentation: insightfulpipe.com/docs
• All MCP Servers: insightfulpipe.com/mcp-servers
• Email: support@insightfulpipe.com

---

Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →

License

MIT License - see LICENSE for details.