X (Twitter) Ads MCP Server: Connect X to Claude AI

X moves fast. Conversations trend and fade within hours. A well-timed promoted tweet can generate massive engagement. A poorly timed one disappears into the void.

But X Ads Manager wasn't built for speed. Finding performance data means navigating a clunky interface, adjusting date ranges, and exporting reports manually.

The X Ads MCP server connects your advertising data directly to Claude AI. Query campaign performance with natural language. Get answers in seconds instead of minutes.

"Which promoted tweets drove the most engagement yesterday?" Just ask.

What Is the X Ads MCP Server

The X Ads MCP server uses Model Context Protocol to give Claude direct access to your X advertising account.

MCP is an open standard from Anthropic that connects AI to external data sources. Instead of copying data into Claude, the server creates a real-time connection. Claude can query your X Ads account directly.

For advertisers on X, this means instant insights without wrestling with the Ads Manager interface.

What Data You Can Access

The X Ads MCP server pulls data from X's Ads API.

Campaign Structure:

Campaigns, ad groups, and promoted tweets
Campaign objectives: reach, engagement, website traffic, conversions
Funding sources and budget allocation

Performance Metrics:

Impressions and reach
Engagements: likes, reposts, replies, clicks
Engagement rate
Cost per engagement and cost per click
Conversions and cost per conversion
Total spend

Tweet-Level Data:

Performance by individual promoted tweet
Organic vs. paid engagement comparison
Media type performance (images, video, text)

Audience Insights:

Follower targeting performance
Interest and keyword targeting results
Demographic breakdown
Device and platform data

Engagement Breakdown:

Replies, reposts, and likes separately
Link clicks vs. profile clicks
Video views and completion rates

Use Cases

Track Real-Time Campaign Performance

X campaigns can spike or tank quickly. Real-time monitoring matters more here than on other platforms.

Ask Claude: "How are my promoted tweets performing today compared to yesterday? Any significant changes in engagement rate?"

Get a quick pulse on campaign health without logging into Ads Manager.

Optimize Promoted Tweet Selection

Not every tweet deserves promotion. Understanding which organic content performs well helps inform paid strategy.

"Which of my promoted tweets have the highest engagement rate this week? What do they have in common?"

Let Claude identify patterns in your top-performing content.

Measure Conversation Participation

X is about real-time conversation. Promoted tweets during trending moments can outperform evergreen content.

"Compare engagement rates for tweets promoted during trending topics versus standard evergreen promotions."

Understand whether real-time marketing is worth the effort for your brand.

Analyze Audience Response

Different audiences respond to different content. X's targeting options let you test this.

"How does my follower-targeted campaign compare to my interest-targeted campaign? Which audience is more engaged?"

Get audience-level insights to refine your targeting strategy.

How to Set Up

Setting up the X Ads MCP server takes about 15 minutes.

Step 1: Apply for X Developer Access

Go to the X Developer Portal and apply for a developer account. You'll need Elevated or Academic access for full Ads API capabilities.

Step 2: Create a Project and App

Once approved, create a project and app in the developer portal. This generates your API keys.

Step 3: Get Ads API Access

Request access to the Ads API specifically. This requires a funded ads account with spending history.

Step 4: Generate Credentials

Generate your API key, API secret, access token, and access token secret. You'll need all four for authentication.

Step 5: Install and Configure

Install the X Ads MCP server and configure it with your credentials and ad account ID.

Step 6: Connect to Claude

Add the server to your Claude configuration file and verify the connection with a test query.

Example Queries

Once connected, ask Claude questions like:

"What's my total X Ads spend this week, and what's the average cost per engagement?"
"Which promoted tweets have the highest engagement rate but lowest conversion rate?"
"Show me my engagement trend over the last 30 days. Is it improving or declining?"
"Compare video tweet performance to image tweet performance. Which format drives more engagement?"
"What times of day do my promoted tweets get the most engagement?"
"Which campaigns are pacing ahead of budget? Should I adjust daily caps?"

Specific questions with clear metrics get the best answers.

Common Questions

Does this include organic tweet data?

The X Ads MCP server focuses on paid advertising data. Organic analytics require a separate connection through X's standard API.

Can I see which replies and reposts my ads generate?

You can see aggregate engagement metrics including reply, repost, and like counts. Individual reply content isn't included in the Ads API.

How does X attribution work?

X uses its own attribution model. The MCP server reflects whatever data X's Ads API provides, including view-through and click-through conversions based on your account settings.

Can I promote tweets through Claude?

Currently, MCP servers focus on reading data. Campaign management and tweet promotion remain in X Ads Manager. Analysis and insights happen through Claude.