Back to Blog
AutomationMar 7, 202612 min read

How to Automate X (Twitter) Ads with Claude AI and MCP — Honest Workflows for a Platform in Transition

NT

Nikhil Tiwari

MCP Playground

📖 TL;DR — Key Takeaways

  • The X Ads MCP server connects Claude to your X (Twitter) ad account — live campaign data, engagement metrics, and audience insights via natural language
  • X's keyword targeting is genuinely unique: target by what people tweet and engage with, not just interest categories — this is the platform's most underused capability
  • Confirmed MCP options: Adzviser (managed, multi-platform) and CData Connect AI (full read/write)
  • X CPM averages ~$2.09 — lower than Meta — but engagement signals are broader and require careful interpretation
  • X Ads performs best for tech, finance, crypto, news, and B2B brands whose audience is actively on the platform. This guide is honest about when it does not.

⚠️ Community-Built Tools — Not Official X Products

The MCP integrations covered in this guide (Adzviser, CData Connect AI, Insightful Pipe) are built by independent companies — not by X Corp. They are not official X products and are not affiliated with, endorsed by, or supported by X. They connect via X's public Ads API but are independently maintained. Always review the source and terms before connecting a live ad account.

X (formerly Twitter) occupies an unusual position in the paid media landscape. It is simultaneously one of the most powerful platforms for certain audiences — tech founders, finance professionals, crypto investors, journalists, political operatives — and genuinely wrong for others. The brands that do well on X know exactly who they are reaching. The brands that struggle are usually trying to reach an audience that simply isn't there.

This guide is written with that context in mind. We will cover what the X Ads MCP server can actually do, which workflows deliver real value, and where Claude's access to live X campaign data makes a measurable difference. We will also be direct about the platform's limitations and which business types should look elsewhere.

If X is part of your media mix — or you're evaluating whether it should be — here is what connecting Claude to your X Ads account via MCP makes possible.


What Is the X Ads MCP Server?

The X Ads MCP server implements the Model Context Protocol — the open standard that lets AI models connect to external tools and data sources with live, authenticated access.

It connects Claude to the X Ads API, giving it access to your campaign data, line item performance, promoted tweet analytics, and audience engagement metrics. Ask Claude how your campaigns performed this week — it queries live data. Ask which keywords are generating the most engagement at the lowest CPE — Claude pulls the breakdown. Ask where budget is leaking across line items — Claude surfaces the answer without you touching Ads Manager.

X's campaign structure has three levels: Campaigns (budget and schedule), Line Items (targeting, bidding, placement — equivalent to ad groups on other platforms), and Promoted Tweets (the creative content). Claude with MCP access can analyze and, with the right server, act across all three levels.

🔑 Keyword Targeting

Target by what people actively tweet and engage with — no other major platform offers this

📊 Engagement Analytics

Retweets, replies, likes, link clicks — all counted as engagement with cost per engagement reporting

👥 Follower Ads

Unique ad format for audience building — target users similar to followers of any public account

⚡ Real-Time Context

Align ads with trending topics and breaking news moments — no other platform provides this in real time


Honest Platform Context — Read Before You Invest

When X Ads makes sense:

  • Tech and SaaS: Developers, founders, and product buyers are highly active on X. B2B tech brands consistently report strong CPL from X relative to other platforms for this audience.
  • Finance, crypto, and investing: X remains the dominant real-time platform for financial conversation. If your audience follows market news and commentary, they are on X.
  • News, media, and entertainment: X's real-time feed makes it uniquely effective for time-sensitive content, event-based campaigns, and breaking news adjacency.
  • Brand awareness for engaged communities: Niche audiences with strong X presence — sports, gaming, politics — respond well to promoted content that feels native.

When X Ads may not be the right channel:

  • DTC e-commerce: Product discovery and shopping intent are stronger on Meta, Pinterest, and TikTok. X users are not primarily in shopping mindset.
  • Visual lifestyle brands: X is text-forward. If your product needs lifestyle imagery to convert, other platforms will outperform at lower CPM.
  • Broad consumer brands: X's active user base skews toward specific demographics and interests. Mass-market consumer products rarely find efficient scale here.

The X Ads MCP server is most valuable when you already know X is the right channel and want to run it more efficiently — not as a tool to evaluate whether the platform is worth testing.


Server Options Compared

1. Adzviser — Managed Remote MCP (Easiest)

Builder: Adzviser
Setup time: Under 5 min
Write ops: No — analytics and reporting
Cost: From $0.99/month
Multi-platform: X + Google + Meta + LinkedIn + 30+ others
Auth: OAuth — no developer app required

Adzviser's X Ads integration is the fastest path to X campaign data in Claude. Connect via OAuth, add the Adzviser MCP URL to Claude Desktop, and immediately start querying your live X Ads performance. The key advantage: X, Google Ads, Meta Ads, LinkedIn Ads, and 30+ other platforms are all accessible in the same Claude session — useful for teams running X alongside other channels.

Best for: Marketing teams who want cross-platform analysis without technical setup. Best value if you're already using Adzviser for other ad platforms.

2. CData Connect AI — Full Read/Write, Enterprise-Grade

Builder: CData Software
Setup time: 20–40 min
Write ops: Full read/write via Connect AI
Cost: Subscription (Connect AI)
Auth: OAuth (browser-based X authentication)
Requirement: Java 17+ (bundled with Claude Desktop on Windows)

CData Connect AI provides a remote MCP server that enables Claude to securely query and act on your X Ads data. It channels SQL operations — including filters and JOINs across X Ads entities — directly to the X Ads API. Supports Campaigns, Line Items, Promoted Tweets, and Analytics tables with full read capability and write operations via CData's Connect AI platform.

Best for: Enterprise teams and developers who need structured query access across X Ads entities with full write capability.

3. Insightful Pipe — Analytics-Focused, Cross-Channel

Builder: Insightful Pipe
Setup time: Under 10 min
Write ops: No — analytics and reporting
Cost: Subscription-based
Platforms: X + 30+ others including Google, Meta, LinkedIn, TikTok
Auth: Managed auth, no API credentials

Insightful Pipe includes X (Twitter) Ads as part of its multi-platform MCP offering. Best suited for reporting workflows: automated weekly performance summaries, cross-channel ROAS comparisons, and scheduled optimization reports without any infrastructure to manage.

Best for: Agencies running X Ads as part of a broader media mix who need automated cross-channel reporting.

Before connecting to a live account: Explore how MCP servers work at MCP Playground — paste any MCP server URL, inspect its tools, and run requests in your browser with no installation required.


Tool Surface — What Claude Can Access

X Ads MCP servers expose tools across the full campaign hierarchy — accounts, campaigns, line items, promoted tweets, and analytics:

Account & Campaign Management

Tool What It Does
get_accountsList all X Ads accounts accessible with your credentials
get_campaignsRetrieve campaigns with objective, status, daily/total budget, and schedule
create_campaignLaunch a campaign with objective (Reach, Engagement, Website Traffic, App Installs, Followers, Video Views)
update_campaignModify budget, name, status, or end date

Line Item (Ad Group) Operations

Tool What It Does
get_line_itemsRetrieve line items with targeting, bid strategy, and placement configuration
create_line_itemCreate a line item with audience targeting (keywords, followers, interests, demographics)
update_line_itemModify bid, targeting, or delivery status
get_targeting_criteriaView active targeting rules: keywords, follower look-alikes, interest categories, locations

Promoted Tweet Management

Tool What It Does
get_promoted_tweetsList all promoted tweets with creative content and delivery status
create_promoted_tweetPromote an organic tweet within a line item
update_promoted_tweetPause, resume, or swap creative

Analytics & Reporting

Tool What It Does
get_campaign_statsCampaign-level performance: impressions, engagements, CPE, CPM, link clicks, spend, conversions
get_line_item_statsLine item performance with same metric set — compare targeting approaches
get_promoted_tweet_statsTweet-level breakdown: retweets, likes, replies, link clicks, video views, CPE per tweet
get_audience_insightsDemographic breakdown of reach by age, gender, location, device

Setup: Two Paths to Connection

Path 1 — Adzviser (5 Minutes, Managed)

Setup time: ~5 minutes  |  Cost: From $0.99/month
Best for teams who want X Ads data in Claude alongside other ad platforms, no technical setup.

  1. Sign up at adzviser.com
  2. Connect your X Ads account via OAuth
  3. Copy your Adzviser MCP server URL
  4. Add to Claude Desktop config at ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "x-ads": {
      "url": "https://mcp.adzviser.com/x-ads?api_key=YOUR_ADZVISER_KEY"
    }
  }
}

Path 2 — CData Connect AI (Full Read/Write)

Setup time: 20–40 minutes  |  Cost: CData Connect AI subscription
Best for teams who need full write access — pausing line items, updating bids, campaign changes.

  1. Log into CData Connect AI and create an account
  2. Click Sources → Add Connection → Select "Twitter Ads"
  3. Authenticate via OAuth (browser-based — X requires interactive auth)
  4. Copy the generated remote MCP server URL
  5. Add to Claude Desktop config with your Connect AI credentials
{
  "mcpServers": {
    "x-ads": {
      "url": "https://cloud.cdata.com/api/odata4/TwitterAds",
      "headers": {
        "Authorization": "Bearer YOUR_CDATA_TOKEN"
      }
    }
  }
}

Note: Java 17+ is required to run the CData MCP server locally. On Windows, Claude Desktop includes a bundled JRE so this is typically handled automatically.


Workflow 1 — Morning Engagement Audit (Understanding X's Broader Metric)

X defines "engagement" more broadly than any other ad platform. A single interaction that counts as an engagement includes: link clicks, retweets, likes, replies, profile clicks, hashtag clicks, and media expansions. This means your engagement rate and CPE figures require more interpretation than on Meta or Google — high engagement does not automatically mean high purchase intent.

Claude with the X Ads MCP server can break engagement down into its components, so you can distinguish between high-value engagements (link clicks, conversions) and vanity engagements (likes, profile clicks).

You: "Give me a 7-day performance summary across all active X campaigns.
For each line item, break engagement into link clicks vs. other
engagements. Flag anything where 'other engagements' is more than
80% of total — that usually means the tweet is getting attention
but not driving traffic."

Claude pulls data via get_campaign_stats and get_line_item_stats:

"7-day X Ads summary — 4 active campaigns:

🔴 HIGH VANITY ENGAGEMENT (review creative):
- 'Tech Audience — Promoted Tweet A' — Total engagements: 2,840
  Link clicks: 180 (6.3%) | Other: 2,660 (93.7%)
  CPE: $0.14, but Cost per link click: $2.21
  The tweet is getting likes and retweets but not driving traffic.
  Recommend testing a tweet with a stronger direct CTA.

✅ HIGH-VALUE ENGAGEMENT (performing well):
- 'SaaS — Keyword Targeting' — Total engagements: 1,420
  Link clicks: 890 (62.7%) | Other: 530 (37.3%)
  Cost per link click: $0.67 — strong for this audience.
  Recommend increasing line item budget.

- 'Followers Campaign' — 410 new followers, CPF: $1.80
  Within target range for B2B SaaS follower acquisition."

Workflow 2 — Keyword Targeting Analysis (X's Most Underused Capability)

X's keyword targeting is genuinely different from any other ad platform. On Google, you target what people search for. On Meta, you target interest categories inferred from behavior. On X, you target based on the actual words people have tweeted and engaged with in the past 30 days — a direct signal of their current conversation and mindset.

This makes X keyword targeting exceptionally precise for niche B2B audiences. A cybersecurity company can target people who have recently tweeted about "zero-day vulnerabilities" or "SOC tools." A developer tool can target people engaging with tweets about "TypeScript performance" or "React 19." No other platform offers this specificity.

You: "Analyze keyword targeting performance across all line items in
the 'Developer Tools' campaign for the last 14 days. Which keyword
groups have the lowest cost per link click? Which are high engagement
but low CTR? Are there keyword categories we're missing?"

Claude analyzes via get_line_item_stats and get_targeting_criteria:

"Keyword performance — 'Developer Tools' campaign (14 days):

TOP PERFORMERS (lowest cost per link click):
- Keywords: 'typescript', 'nextjs', 'react hooks' — CPL: $0.54
- Keywords: 'api integration', 'developer productivity' — CPL: $0.71

HIGH ENGAGEMENT, LOW CTR (intent mismatch):
- Keywords: 'open source', 'github' — Engagement: 1,840, CTR: 2.1%
  These keywords attract developers but the tweet copy may not
  align with their current intent. Recommend testing more specific
  problem-focused messaging for this keyword group.

GAPS — Not currently targeted but likely relevant:
- 'llm api', 'claude api', 'openai api' — High conversation volume
  in your audience's network, not in current targeting.
- 'cursor ide', 'claude code' — Active developer conversation.
  Recommend testing these in a new line item."

Workflow 3 — Follower Campaign Optimization

X's Follower Ads (Promoted Accounts) are unique to the platform. No other major ad network lets you run a campaign specifically designed to grow your own audience. The targeting works by identifying users similar to the followers of accounts you specify — your own account, competitors, adjacent influencers, or industry publications.

The metric to watch is Cost Per Follow (CPF). Industry benchmarks for B2B SaaS range from $1.50–$4.00 per follower depending on audience specificity. Claude can analyze which targeting approaches are delivering within that range and which are above it.

You: "How is our follower campaign performing over the last 30 days?
Break down CPF by follower targeting group. Which look-alike sources
are delivering the most cost-efficient followers? Which should we cut?"

Claude calls get_line_item_stats with follower campaign filter:

"Follower campaign performance — last 30 days:

EFFICIENT (scale):
- Look-alike: @YCombinator followers — CPF: $1.42, 284 new followers
  High-quality B2B tech audience. Budget under-allocated.
- Look-alike: @ProductHunt followers — CPF: $1.89, 201 new followers
  Strong fit for SaaS audience. Recommend increasing bid.

ABOVE TARGET (reduce):
- Look-alike: @TechCrunch followers — CPF: $4.10, 67 new followers
  Broad tech media audience has lower conversion to follow.
  Reduce daily spend and test more specific account look-alikes.

UNDERPERFORMING (pause):
- Interest: 'Technology' category — CPF: $6.30, 31 new followers
  Interest-based targeting significantly less efficient than
  account look-alike targeting for this objective.
  Recommend pausing and reallocating to top performers."

Workflow 4 — Video Ad Performance Analysis

X video ads have lower CPMs than other formats on the platform. Early data from X's own reporting showed vertical video formats achieving approximately 14% lower CPMs than standard placements. Video also gives you an additional performance signal — video completion rate — that static promoted tweets lack.

You: "Compare video ad performance vs. static promoted tweets across
our account for the last 30 days. Show CPM, link CTR, and cost per
link click for each format. Which is delivering better for our goal
of driving website traffic?"

Claude analyzes via get_promoted_tweet_stats with format breakdown:

"Video vs. Static Promoted Tweets — last 30 days:

                    Video Ads    Static Tweets
CPM                 $1.74        $2.31
Link CTR            3.2%         2.1%
Cost per link click $0.54        $1.10
Total link clicks   1,840        920

Video is outperforming static across every metric for your
website traffic objective. The CPM advantage compounds with
higher CTR — resulting in 2x cost efficiency per click.

Recommendation: Shift 70% of promoted tweet budget to video format.
Maintain static tweets for engagement/retweet campaigns where
the format is more shareable. Test 15s vs. 30s video lengths
to find the optimal completion rate vs. CTR balance."

Workflow 5 — Budget Reallocation Across Campaign Objectives

X campaigns run across multiple objectives simultaneously — awareness, engagement, website traffic, app installs, and followers. Each has a different cost structure and measurement approach. Claude can give you a portfolio view of how budget is distributed vs. where it's delivering, and surface imbalances you wouldn't see by looking at campaigns individually.

You: "Give me a 30-day portfolio view of all X campaigns. How is
budget split by objective? Which objectives are hitting our
efficiency targets and which are not?"

Claude analyzes via get_campaign_stats across all campaigns:

"30-day X Ads portfolio — budget by objective:

Objective          Spend/day   Key Metric        vs. Target
Website Traffic    $280        CPC: $0.54        ✅ Target: $0.80
Followers          $150        CPF: $1.65        ✅ Target: $2.00
Engagement         $200        CPE: $0.18        ⚠️ Link CTR only 5%
App Installs       $120        CPI: $4.20        ❌ Target: $2.50

Recommendation:
- Website Traffic: increase to $400/day — highest efficiency
- Followers: maintain — within target
- Engagement: restructure to optimize for link clicks, not total
  engagements — current tweet creative drives likes not clicks
- App Installs: pause — CPI is 68% above target with no improving
  trend over 4 weeks. Reallocate $120/day to Website Traffic."

Platform Benchmarks — What the Data Actually Shows

Source note: All figures below are from published industry research and X's own documentation. We have not included speculative projections or unverified case studies.

$2.09

Average CPM on X

vs. Meta's $2.53 CPM — Hootsuite data

$0.58

Average CPC for X Ads

Industry average — varies significantly by niche

14%

Lower CPM for vertical video vs. other formats

X internal data

$0.13–0.20

Median CPE (cost per engagement)

Industry benchmarks — note: engagement is broad


Honest Limitations — What Claude Cannot Fix

MCP access does not solve platform-level challenges:

  • Brand safety context: X's content moderation approach has changed since 2022. Some advertisers have reduced spend for brand safety reasons. Claude cannot assess the content environment your ads appear near — that requires manual review of placement settings.
  • Attribution limitations: X's conversion tracking requires the X Pixel or Conversion API. If your pixel implementation is incomplete, Claude cannot improve data it doesn't have.
  • Engagement inflation: X's broad engagement definition makes CPE benchmarks misleading. Claude can break down engagement by type, but a low CPE does not guarantee business value — you must define which engagement types matter for your goal.
  • Audience size constraints: Keyword targeting on X can produce very small addressable audiences for niche B2B products. Claude can identify this but cannot expand an audience that isn't there.
  • Write operations require CData: Adzviser and Insightful Pipe are analytics-only — Claude can surface recommendations but cannot execute changes. For write operations, CData Connect AI is required.

The honest value proposition: X Ads MCP is most useful for teams already running X Ads at meaningful scale who spend significant time pulling reports, interpreting engagement breakdowns, and manually comparing line item performance. Claude eliminates that manual work. It does not fix campaigns that are underperforming because of audience fit or creative issues — those require human judgment.


Combining X Ads MCP with Other Servers

Cross-Platform Media Mix

X Ads MCP + LinkedIn Ads MCP + Google Ads MCP
→ Claude compares CPC, CPL, and conversion rates across all three B2B channels
→ Identifies where X Ads is incrementally contributing vs. where spend is duplicating other channels
→ Recommends budget shifts across the full B2B media mix

Automated Engagement Reporting

X Ads MCP + Google Sheets MCP
→ Claude pulls weekly X Ads performance every Monday
→ Breaks engagement into link clicks vs. other engagements automatically
→ Formats into client report template in Google Sheets — 1 hour → 5 minutes

Real-Time Event Campaign Monitoring

X Ads MCP + Slack MCP
→ Claude monitors hourly campaign spend during live events (product launches, conferences)
→ Posts alert to #x-ads Slack if CPE spikes or spend pace exceeds daily cap
→ Enables real-time campaign adjustments during time-sensitive moments

Getting Started Today

If you are a marketer (non-technical):

  1. Sign up at Adzviser — under 5 min setup
  2. Connect your X Ads account via OAuth
  3. Install Claude Desktop and add the MCP config
  4. Start with the morning engagement audit — separate link clicks from other engagements first

If you need write access (developer / ops):

  1. Create a CData Connect AI account
  2. Add a Twitter Ads connection and authenticate via OAuth
  3. Copy the remote MCP server URL
  4. Add to Claude Desktop config — enables full campaign management

Want to explore MCP before committing to a setup?

Connect to any MCP server in your browser — inspect tools, run live requests, no install needed.

Disclaimer: X Ads MCP integrations are unofficial, third-party tools and are not affiliated with or endorsed by X Corp. Always review X's Ads API terms of service before connecting. Write operations execute against live accounts immediately — review all changes before approving.

Frequently Asked Questions

Is X Ads API access still available after the 2023 API changes?+
Yes. The X Ads API (formerly Twitter Ads API) remains available for advertisers with active X Ads accounts. The API changes X made in 2023 primarily affected the free developer tier and organic content APIs. The Ads API, which requires an active advertising relationship with X, has remained accessible. Adzviser and CData Connect AI both confirm active support for X Ads API connections.
How does X's "engagement" metric compare to engagement on Meta or Google?+
X's engagement metric is significantly broader. On X, engagements include likes, retweets, replies, link clicks, profile clicks, hashtag clicks, media expansions, and card clicks — all counted equally. On Meta, engagement typically means post interactions. On Google, you're measuring clicks and conversions. This makes CPE on X appear very low, but it doesn't mean every engagement has the same value. Always segment your X reporting to isolate link clicks from other engagement types to get a meaningful comparison.
What is keyword targeting on X and how is it different from other platforms?+
X keyword targeting reaches users based on keywords they have recently tweeted or engaged with — not search queries (Google) or inferred interests (Meta). This means you can reach people mid-conversation about a specific topic, which is uniquely valuable for niche B2B audiences and time-sensitive campaigns. For example, you can target people who have tweeted about "SOC 2 compliance" in the last 30 days — something no other platform can do.
Can Claude make changes to my X campaigns automatically?+
With Adzviser and Insightful Pipe (analytics-only), Claude can surface recommendations but cannot execute changes — you make changes manually in X Ads Manager. With CData Connect AI (full read/write), Claude can make changes, but will describe the action and request your confirmation first. Claude does not take autonomous action unless you explicitly instruct it to proceed.
Which types of businesses get the best results from X Ads?+
Based on consistent reporting from X advertisers: B2B tech and SaaS, developer tools, finance and fintech, crypto and web3, news and media, and entertainment brands with engaged fan communities. DTC e-commerce, broad consumer brands, and lifestyle products typically find better ROI on Meta, Pinterest, or TikTok where shopping intent is higher. X excels when your audience is actively conversational about your category on the platform.

Related Guides


X Ads MCP integrations are unofficial tools not affiliated with or endorsed by X Corp. Always review X's Ads API terms of service for your use case.


Resources:

NT

Written by Nikhil Tiwari

15+ years in product development. AI enthusiast building developer tools that make complex technologies accessible to everyone.