MCP For Claude Marketplace
X Ads (Twitter)

X Ads (Twitter) MCP Connector for Claude

A+

Connect your X Ads account to any AI agent — audit campaigns, analyze line item performance, and pull engagement reports through natural conversation.

13 tools Official Updated Jun 28, 2026 Official Vinkius Partner
More Details Connect to Claude

Connect your X Ads account to any AI agent and manage your entire advertising operation through natural conversation.

What you can do

Campaign Management

  • Ad Accounts — List every ad account tied to your profile, inspect statuses, and retrieve funding instrument details
  • Campaigns — Browse active, paused, or draft campaigns and understand their structure at a glance
  • Line Items — Audit individual line items to review targeting, bidding strategy, and delivery status
  • Ads — Inspect the ads running under each line item, including creative associations

Analytics & Reporting

  • Performance Metrics — Pull daily engagement, spend, and conversion data for any campaign, line item, or ad
  • Custom Date Ranges — Specify exact start and end dates to generate reports for any period
  • Metric Groups — Choose between Engagement, Billing, Web Conversion, Video, and Mobile Conversion metrics

Creative Governance

  • Promoted Tweets — List all promoted tweets tied to an account to verify what content is currently running
  • Funding Instruments — Review billing methods and payment sources attached to each ad account

How it works

  1. Subscribe to this server
  2. Enter your API Key, API Secret, Access Token, and Access Token Secret from the X Developer Portal
  3. Start auditing campaigns and pulling reports from Claude, Cursor, or any MCP-compatible client

All requests are signed with OAuth 1.0a at runtime. Your credentials are encrypted at rest and never exposed.

Who is this for?

  • Performance Marketers — pull weekly spend and engagement summaries without opening the Ads Manager
  • Ad Operations Teams — verify campaign configurations and promoted tweet statuses in seconds
  • Growth Leads — compare line item performance across campaigns to reallocate budget
  • Agencies — audit multiple client accounts from a single AI interface
ad-campaignsperformance-analyticsmarketing-auditreal-time-biddingsocial-advertisingroi-tracking

13 tools expose this connector's capabilities to your AI agent.

get_ad_account

Use this to verify an account is active before querying campaigns. Get detailed metadata for a specific X Ads account

list_ad_accounts

Returns account IDs, names, statuses, and approval states. The account ID returned here is required by all other tools. List all X (Twitter) Ads accounts accessible by the authenticated user

list_ads

Each ad references the line item it belongs to and the creative (tweet) it promotes. List all individual ads within an X Ads account

list_campaigns

Each campaign includes its name, status, funding instrument, daily budget, and total budget. Use list_ad_accounts first to get the account ID. List all campaigns within an X Ads account

list_funding_instruments

Useful for verifying billing is set up before launching campaigns. List payment methods and billing sources attached to an X Ads account

list_line_items

Line items define the targeting and bidding strategy within a campaign. List all line items across campaigns in an X Ads account

get_analytics

Metric groups: ENGAGEMENT, BILLING, VIDEO, WEB_CONVERSION, MOBILE_CONVERSION. Dates must be ISO 8601 format (e.g., 2026-06-01T00:00:00Z). Pull performance analytics for campaigns, line items, or ads over a date range

get_campaign

Use list_campaigns first to find the campaign ID. Get full details for a specific campaign by its ID

get_line_item

Use list_line_items first to find the line item ID. Get full details for a specific line item by its ID

list_media_creatives

Use this to audit which creative assets are currently active. List all media creative assets (images and videos) used in an X Ads account

list_promoted_tweets

Use this to verify which tweets are actively being promoted. List all promoted tweets currently running or paused in an X Ads account

list_tailored_audiences

Useful for understanding retargeting strategy. List custom audiences (tailored audiences) for retargeting and CRM matching

list_targeting_criteria

Requires both the account ID and line item ID. List all targeting criteria applied to a specific line item

See how to talk to your AI agent using X Ads (Twitter).

List all my X ad accounts and tell me which ones are active.

You have 2 ad accounts: 1. **SaaS Growth** (ID: abc123) — Active, funding via credit card ending in 4242 2. **Product Launch Q2** (ID: def456) — Paused since June 3 Would you like me to pull the active campaigns for 'SaaS Growth'?

Show me the engagement metrics for all line items in account abc123, from June 1 to June 14.

Here are the engagement metrics for your 3 line items between June 1–14: | Line Item | Impressions | Clicks | Spend | CTR | |---|---|---|---|---| | Retargeting — Webinar | 42,100 | 1,230 | $312 | 2.92% | | Lookalike — SaaS | 38,500 | 890 | $278 | 2.31% | | Brand Awareness | 91,200 | 620 | $445 | 0.68% | The retargeting line item is outperforming by CTR. Would you like a day-by-day breakdown?

Which promoted tweets are running right now on account abc123?

You have 4 promoted tweets active on that account: 1. "Just launched our AI integration..." — Linked to 'SaaS Growth' campaign 2. "Watch the full product demo..." — Linked to 'Video Launch' 3. "Free trial — no credit card..." — Linked to 'Retargeting' 4. "Case study: 3x pipeline in 60 days..." — Linked to 'Lookalike' Want me to pull engagement stats for any of these?

In the [X Developer Portal](https://developer.x.com/), open your App under your Project. Under **Keys and Tokens**, you will find the **API Key** (Consumer Key) and **API Key Secret** (Consumer Secret). Below that, generate your **Access Token** and **Access Token Secret**. All four are required because the X Ads API uses OAuth 1.0a request signing.

Related Connectors

BR

Brevo MCP

11 tools Official

Engage customers across email, SMS, and chat with marketing campaigns and transactional messaging that scale with you.

A+ View details →
AP

API-Football MCP

8 tools Official

Comprehensive football data platform — get live scores, standings, and player stats via AI.

A+ View details →
AL

Alegra MCP

14 tools Official

Automate cloud accounting via Alegra — issue invoices, manage contacts, track inventory, and monitor bank accounts from any AI agent.

A+ View details →
LE

Leal MCP

12 tools Official

Retain customers in Latin America with digital loyalty programs, cashback rewards, and personalized offers for retail businesses.

A+ View details →