X Ads
X Ads MCP server
Get MCP Ads connects X Ads to Claude, ChatGPT and other assistants through X’s official Ads MCP server. Sign in with X and tick the ad accounts to share; every change shows a preview first, and new campaigns start paused.
Free with 1 ad account, no card. Pro is free for 7 days. Facts verified on October 24, 2026.
Connection
Connect X Ads to Claude and ChatGPT
Add the X Ads URL to your assistant, sign in with X and approve its consent screen, then tick the ads accounts to share. A new campaign needs a funding source on the X account.
Setup guides: Claude, ChatGPT, Claude Code, Codex, Cursor, Muse, Hermes, OpenClaw, Gemini.
- 1
Continue with X
ads.readads.writemedia.writeoffline.access - 2
Tick the ads accounts to share
- Form Running US18ce5k2m9qa
- Form Running Outlet18ce5k2m9ub
- Velo Club18ce5k2mb7c
- 3
Add the URL to your assistant
https://mcp.getmcpads.com/x-ads/mcp
X’s own server
Built on X’s Ads MCP server
X runs its own Ads MCP server at ads-api.x.com/mcp, and Get MCP Ads relays it with the token from your X sign-in. Around it, Get MCP Ads adds your choice of accounts, a preview before each change, media uploads through X’s media API, alerts, Google Sheets and the other platforms.
Source: X’s Ads MCP documentation, checked October 24, 2026.
Capabilities
What your assistant can do in X Ads
It reads X campaigns, ad groups and promoted posts for the ads accounts you tick, and prepares changes that you confirm before they apply.
Spend, reach and frequency
Account statistics by campaign, ad group and promoted post, with reach and average frequency: 75 metrics.
Targeting and line items
The targeting of each ad group, and budgets, schedules and frequency caps changed after a preview.
Paused campaigns and website cards
Campaigns and ad groups are created paused; website cards take one image or video, or a carousel of 2 to 6, with one destination.
- Reads
- Changes with a preview
- Created paused
- Launcher
- Alerts
- Google Sheets
On X Ads, every assistant answers in text and tables, Claude and ChatGPT included.
Hosted server: 51 tools, 23 of them write. Tool catalog updated October 16, 2026.Tool reference
Requests
Requests that work
Requests and the tools that answer them. A change stops at its preview until you confirm it.
- Spend, impressions and link clicks by campaign for the last 7 days.x_ads_list_campaigns · x_ads_get_account_stats
- What reach and average frequency did the Black Friday Teaser campaign get this month?x_ads_get_campaign_reach
- Which targeting is set on the US Retargeting ad group?x_ads_list_targeting_criteria
- Raise US Prospecting to $150 a day and cap frequency at 3 a week.x_ads_update_line_item
- Create a paused Website Clicks campaign, Fall Sale 2026 US, with a $100 daily ad group targeting the United States.x_ads_create_campaign · x_ads_create_line_item · x_ads_add_targeting_criterion
- Upload this 15-second MP4 and run it as a website card in the paused Holiday Gift Guide ad group.x_ads_upload_media · x_ads_create_card · x_ads_create_ad_post · x_ads_promote_post
RequestWhich targeting is set on the US Retargeting ad group?
Answer, in text
US Retargeting, in Form Running US, targets:
| Targeting | Value |
|---|---|
| Location | United States |
| Age | 25 to 54 |
| Audience | Site visitors, last 30 days |
| Platforms | iOS and Android |
Nothing else is set on this ad group.
Limits
Limits
What the X Ads server does not do, said plainly.
- Uploads stop at 5 MB for an image, 15 MB for a GIF and 16 MB for an MP4.
- Website cards only; a card is not edited after it is created, a new card replaces it.
- Budgets, schedule and pacing live on the ad groups, not on the campaign.
- No creative gallery, business review or account indicators for X. Delivery eligibility and account checks stay with X.
Open source
Open source X Ads MCP server
Run it on your machine with your own X credentials, in Claude Desktop, Claude Code, Cursor and other local MCP clients. It calls X’s Ads MCP server too, with the same tools as the hosted server.
X Ads MCP: questions
- Yes. X runs its own Ads MCP server at ads-api.x.com/mcp, and Get MCP Ads is built on it: it relays X’s server with your X sign-in and adds your choice of accounts, previews, alerts and Sheets.
- The X Ads MCP server, at ads-api.x.com/mcp, is the one for advertising, and the one Get MCP Ads relays. Posting, reading timelines or other X API work is not what this page is about.
- No. X’s API developer credits are separate from your ad budget.
- Yes, MP4 videos up to 16 MB and GIFs up to 15 MB, through X’s media API. The Launcher uploads your files to X itself, then builds the website cards and carousels around them.
- Every plan includes X Ads. Free reads and reports on 1 ad account, without changes. Changes with a preview and launches start on Pro; hourly alerts on Team.
X Ads from your AI assistant
Free with 1 ad account, no card. Pro is free for 7 days.