What is an X Ads MCP server?

An X Ads MCP server connects your X (Twitter) Ads account to Claude AI using the Model Context Protocol. You can query campaign data and get insights using natural language.

What X Ads data can I access?

You can access campaign metrics, tweet performance, engagement data (likes, retweets, replies), follower metrics, video completion rates, and conversion tracking.

Does it support all X ad formats?

Yes, the MCP server supports Promoted Tweets, Follower Ads, Video Ads, and other X advertising formats.

Is X advertising effective?

X (Twitter) is effective for real-time marketing, B2B targeting, and reaching audiences engaged in current events and conversations. Results vary by industry and campaign objective.

Can I track conversions?

Yes, when you have the X Pixel installed, you can query conversion data including website visits, purchases, and custom conversion events.

X Ads MCP

advertising64 actions

Get started for free View All 64 Actions

Ask your X Ads anything

Pull reports, find insights, and take action on X Ads.
Just ask. No dashboards, no exports, no waiting.

ChatGPT

Online

Available Actions

64 actions available to automate your X Ads workflows.

Read Actions (45)

Get Account

Read

Get details for a specific ad account.

Get Campaigns

Read

List all campaigns for an ad account.

Get Campaign

Read

Get details for a specific campaign.

Get Line Items

Read

List all line items (ad groups) for an ad account.

Get Line Item

Read

Get details for a specific line item.

Get Media Creatives

Read

List all media creatives for an ad account.

Get Media Creative

Read

Get details for a specific media creative.

Get Funding Instruments

Read

List all funding instruments for an ad account.

Get Funding Instrument

Read

Get details for a specific funding instrument.

Get Promoted Tweets

Read

List promoted tweets associated with line items.

Get Promoted Tweet

Read

Get details for a specific promoted tweet.

Get Promoted Accounts

Read

List promoted accounts associated with line items.

Get Promoted Account

Read

Get details for a specific promoted account.

Get Targeting Criteria

Read

List targeting criteria associated with line items.

Get Targeting Criterion

Read

Get details for a specific targeting criterion.

Get Promotable Users

Read

List promotable users for the current account.

Get Scheduled Promoted Tweets

Read

List scheduled promoted tweets for the account.

Get Account Media

Read

List account media assets for the current account.

Get Media Library

Read

List media library objects for the current account.

Get Media Library Item

Read

Get details for a specific media library object.

Get Cards

Read

List cards (website, app, carousel) for the account.

Get Card

Read

Get details for a specific card.

Get Tracking Tags

Read

List tracking tags for the current account.

Get Tracking Tag

Read

Get details for a specific tracking tag.

Get Account History

Read

Retrieve change history for an entity on the account.

Get Tax Settings

Read

Retrieve tax setting details for the current account.

Get Features

Read

Retrieve features enabled for the current account.

Get Authenticated User Access

Read

Retrieve the authenticated user's account permissions.

Get Recommendations

Read

Retrieve campaign optimization recommendations.

Get Targeting Suggestions

Read

Get keyword or user targeting suggestions.

Get Targeting Locations

Read

Discover location-based targeting criteria.

Get Targeting Interests

Read

Discover interest-based targeting criteria.

Get Targeting Languages

Read

Discover language targeting criteria.

Get Targeting Devices

Read

Discover device-based targeting criteria.

Get Targeting Platforms

Read

Discover platform-based targeting criteria.

Get Targeting Events

Read

Discover event-based targeting criteria.

Get Targeting Conversations

Read

Discover conversation-based targeting criteria.

Get Targeting Tv Shows

Read

Discover TV show-based targeting criteria.

Get Iab Categories

Read

Retrieve IAB content categories.

Get Advertiser Business Categories

Read

Retrieve valid advertiser business categories.

Get Stats

Read

Retrieve synchronous analytics for an account (max 7 days).

Get Active Entities

Read

Get entities with activity in a given time range.

Get Async Jobs

Read

Retrieve status and results for async analytics jobs.

Create Async Job

Read

Create an async analytics job (up to 90 days).

Cancel Async Job

Read

Cancel a processing async analytics job.

Write Actions (19)

Create Campaign

Write

Create a new campaign (starts paused for safety).

Update Campaign

Write

Update an existing campaign.

Delete Campaign

Write

Delete a campaign.

Create Line Item

Write

Create a line item under a campaign (starts paused).

Update Line Item

Write

Update an existing line item.

Delete Line Item

Write

Delete a line item.

Upload Media

Write

Upload an image for use in ads and return a media id.

Create Ad Tweet

Write

Create a promoted-only (nullcast) tweet for ad campaigns.

Create Media Creative

Write

Create a media creative and link it to a line item.

Delete Media Creative

Write

Delete a media creative.

Create Promoted Tweet

Write

Associate tweets with a line item as promoted tweets.

Delete Promoted Tweet

Write

Remove a promoted tweet association.

Create Promoted Account

Write

Associate a user account with a line item.

Create Targeting Criterion

Write

Create a targeting criterion for a line item.

Delete Targeting Criterion

Write

Delete a targeting criterion.

Create Tracking Tag

Write

Create a tracking tag for a line item.

Create Media Library Item

Write

Add a media asset to the account media library.

Create Card

Write

Create a card (website, app, or carousel) for tweets.

Delete Card

Write

Delete a card.

Related MCP Servers

Explore other servers that work well with X Ads

DataForSEO

82 actions

BigQuery

5 actions

Google Analytics 4

8 actions

Google Tag Manager

61 actions

Web Crawler

33 actions

View all MCP Servers →

Example Questions to Ask

Here are some things you can ask your AI assistant about your X Ads data.

“What is my X Ads engagement rate this week?”

Get engagement metrics

“Which promoted tweets have the most retweets?”

Find viral content

“Show me cost per follower for follower campaigns”

Audience growth efficiency

“Compare video vs. image ad performance”

Format analysis

“Which targeting options have the lowest CPA?”

Targeting optimization

X Ads MCP vs Traditional Methods

See why marketers prefer MCP connectors over manual exports and API integrations.

Feature	MCP Server	Manual Export	Raw API
Natural language queries	✓	✗	✗
Real-time data access	✓	✗	✓
No coding required	✓	✓	✗
AI-powered insights	✓	✗	✗
Cross-platform analysis	✓	✗	✗
Setup time	5 minutes	Ongoing	Days/Weeks

Ask your X Ads anything

Available Actions

Read Actions (45)

Get Account

Get Campaigns

Get Campaign

Get Line Items

Get Line Item

Get Media Creatives

Get Media Creative

Get Funding Instruments

Get Funding Instrument

Get Promoted Tweets

Get Promoted Tweet

Get Promoted Accounts

Get Promoted Account

Get Targeting Criteria

Get Targeting Criterion

Get Promotable Users

Get Scheduled Promoted Tweets

Get Account Media

Get Media Library

Get Media Library Item

Get Cards

Get Card

Get Tracking Tags

Get Tracking Tag

Get Account History

Get Tax Settings

Get Features

Get Authenticated User Access

Get Recommendations

Get Targeting Suggestions

Get Targeting Locations

Get Targeting Interests

Get Targeting Languages

Get Targeting Devices

Get Targeting Platforms

Get Targeting Events

Get Targeting Conversations

Get Targeting Tv Shows

Get Iab Categories

Get Advertiser Business Categories

Get Stats

Get Active Entities

Get Async Jobs

Create Async Job

Cancel Async Job

Write Actions (19)

Create Campaign

Update Campaign

Delete Campaign

Create Line Item

Update Line Item

Delete Line Item

Upload Media

Create Ad Tweet

Create Media Creative

Delete Media Creative

Create Promoted Tweet

Delete Promoted Tweet

Create Promoted Account

Create Targeting Criterion

Delete Targeting Criterion

Create Tracking Tag

Create Media Library Item

Create Card

Delete Card

Related MCP Servers

DataForSEO

BigQuery

Google Analytics 4

Google Tag Manager

Web Crawler

Example Questions to Ask

X Ads MCP vs Traditional Methods

Ready to connect your data?