What you can read and write on X
| Area | Read | Write |
|---|---|---|
| Reporting | Stats, async stats jobs, reach, active entities | n/a |
| Campaigns and line items | Campaigns, line items, placements, bidding rules | Create, update, delete, batch create |
| Promotion | Promoted posts, scheduled promoted posts, promoted accounts | Promote posts and schedule promotions |
| Posts and cards | Account posts, drafts, scheduled posts, cards | Create posts, drafts and scheduled posts; poll and conversation cards; pre-roll CTAs |
| Targeting | Interests, locations, events, conversations, TV shows, devices, suggestions | Add, update and remove criteria, batch edits, audience estimates |
| Audiences | Custom audiences, permissions, do-not-reach lists | Create audiences, add users, manage do-not-reach lists |
| Media and measurement | Media library, tracking tags, app event tags | Upload media, tracking tags, conversion events |
| Catalogs and billing | Product catalogs, sets, scheduled feeds, funding instruments | Create catalogs, sets and feeds |
Whathead vs X's official Ads MCP
| X Ads MCP | Whathead | |
|---|---|---|
| Endpoint | ads-api.x.com/mcp | www.whathead.com/mcp |
| Setup | X developer app enrolled in Ads API access, with ads.read and ads.write scopes | Sign in with X through Whathead's app |
| Size | 74 tools | 186 Ads API actions in one gateway |
| Safety | Campaigns and line items always created paused | Dry run by default; deletes need confirmation |
| Other platforms | X only | Meta, 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
Connect X in Whathead
In Integrations, sign in with X and choose the ads accounts to share.
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.
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.
Run it from one workspace
Every plan starts with a 14-day free trial. Only successful live work is metered.
Sources
- X Ads API MCP documentation (docs.x.com)