Whathead
  • Builder
  • MCP server
  • Transfer
  • Guardrails
  • Pricing
  • Blog
  • Docs
Log inSign up free
  1. Home
  2. MCP server
  3. X Ads MCP
X Ads MCP

X Ads MCP server for Claude, ChatGPT and Cursor

Whathead's X Ads MCP server connects Claude, ChatGPT and Cursor to 186 X Ads API actions: campaigns, line items, promoted and scheduled posts, cards, targeting, custom audiences, conversion tags, catalogs and stats. You sign in with X through Whathead, so you do not need your own developer app with Ads API access. Writes are previewed first and deletes need confirmation.

Updated 18 Nov 2026
Start a 14-day trialSee pricing
X Ads API actions
186
Login
X OAuth through Whathead's app
Writes
Dry run first, deletes need confirmation
Monitoring
Anomaly Engine covers X (early access)
Price
From $39/month, 14-day trial
On this page
What you can read and write on XWhathead vs X's official Ads MCPWhen X's own server is enoughSet up the X Ads MCPX Ads prompts to trySafety and plan limitsFAQRelated

What you can read and write on X

AreaReadWrite
ReportingStats, async stats jobs, reach, active entitiesn/a
Campaigns and line itemsCampaigns, line items, placements, bidding rulesCreate, update, delete, batch create
PromotionPromoted posts, scheduled promoted posts, promoted accountsPromote posts and schedule promotions
Posts and cardsAccount posts, drafts, scheduled posts, cardsCreate posts, drafts and scheduled posts; poll and conversation cards; pre-roll CTAs
TargetingInterests, locations, events, conversations, TV shows, devices, suggestionsAdd, update and remove criteria, batch edits, audience estimates
AudiencesCustom audiences, permissions, do-not-reach listsCreate audiences, add users, manage do-not-reach lists
Media and measurementMedia library, tracking tags, app event tagsUpload media, tracking tags, conversion events
Catalogs and billingProduct catalogs, sets, scheduled feeds, funding instrumentsCreate catalogs, sets and feeds

Whathead vs X's official Ads MCP

X details from X's Ads API MCP documentation, checked 18 Nov 2026.
X Ads MCPWhathead
Endpointads-api.x.com/mcpwww.whathead.com/mcp
SetupX developer app enrolled in Ads API access, with ads.read and ads.write scopesSign in with X through Whathead's app
Size74 tools186 Ads API actions in one gateway
SafetyCampaigns and line items always created pausedDry run by default; deletes need confirmation
Other platformsX onlyMeta, TikTok, Snapchat and eight more

When X's own server is enough

If you already have a developer app with Ads API access and only run X, X's server is a solid first-party option, and its paused-by-default creates are a sensible guardrail.

Whathead suits teams without their own Ads API enrolment, or that run X next to Meta, TikTok and Snapchat. In the Whathead app, the Anomaly Engine (early access) checks X setup, budgets and performance, and X is one of three platforms, with Meta and DV360, where it can pause or change budgets automatically, with undo.

  • The MCP transfer tool does not cover X; it supports Meta, TikTok, Snapchat and Google.
  • Anomaly Engine performance rules on X do not include ROAS or revenue.

Set up the X Ads MCP

  1. Connect X in Whathead

    In Integrations, sign in with X and choose the ads accounts to share.

  2. Add Whathead to your assistant

    In Claude or ChatGPT, add a custom connector with https://www.whathead.com/mcp and approve the sign-in. In Cursor, use the same URL with a bearer token from the Whathead MCP page.

  3. Pick an account

    Ask the assistant to list your X ads accounts and funding instruments before you build anything.

X Ads prompts to try

  • Show impressions, engagements and cost per link click by line item for the last 7 days.

  • Create a paused website traffic campaign with one line item targeting followers of these three accounts.

  • Create a poll card post and promote it in line item 9xz.

  • Schedule this post for 9am Monday and promote it in the Launch_Q4 campaign.

  • Create a do-not-reach list from these hashed emails.

  • Estimate the audience for women 25 to 44 in the UK interested in fitness.

  • Pause line items with a cost per click above $2 this week. Show me the preview first.

  • Run an async stats job for all campaigns last month and summarise it by objective.

Safety and plan limits

X writes default to a dry run that shows the exact Ads API request, and DELETE actions also need confirmed: true. Connectors can be restricted to read-only tools or chosen ads accounts.

Plans: MCP Actions at $39 a month covers 1,500 reads and 100 writes across all platforms, Operator Bundle at $65 covers 4,000 and 250, and Agency at $249 covers 15,000 and 750. Every plan begins with a 14-day trial.

Frequently asked questions

Does X have an official Ads MCP server?

Yes. X documents an Ads MCP server at ads-api.x.com/mcp. It needs an X developer app enrolled in Ads API access and creates campaigns and line items paused.

Do I need an X developer account to use Whathead?

No. Whathead connects through its own X app, so you sign in with an X user that has access to your ads accounts.

Is this the same as a Twitter Ads MCP?

Yes. X Ads is the former Twitter Ads, and the actions use the X Ads API, so promoted tweets appear as promoted posts.

Can the assistant create promoted posts from scratch?

Yes. It can upload media, create the post or card, and promote it in a line item, previewing each request before it runs.

Related

  • X Ads operations guide (blog)blog.whathead.com
  • Reddit Ads MCP
  • Meta Ads MCP
  • Ad anomaly detection
  • All platforms on the MCP server
  • Platform tools reference (docs)docs.whathead.com

Run it from one workspace

Every plan starts with a 14-day free trial. Only successful live work is metered.

Start a 14-day trialCompare plans

Sources

  1. X Ads API MCP documentation (docs.x.com)
Whathead© 2026 Whathead. Multi-platform ad operations and an Ads MCP server.
Product
PricingMCP serverMeta Ads MCPGoogle Ads MCPCross-platform transferAd anomaly detectionServer-side trackingGoogle Sheets add-onLooker Studio connector
Compare
Supermetrics alternativePipeboard alternativeRyze AI alternativeWhathead vs Meta’s official MCP
Resources
BlogDocsAboutSupportContact
Legal
Terms of ServicePrivacy PolicyRefundsSecurity & DataLog in