How do I use X Ads MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@X Ads MCP Server Show spend and conversions for each X campaign last week" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

X Ads MCP Server

by adkit

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

X Ads MCP Server

Connect X Ads (Twitter Ads) to Claude, ChatGPT, Cursor, Codex or any AI app that supports MCP. AdKit hosts the server, so you only add an address to your AI app.

MCP address: https://mcp.adkit.so/x-ads
Website: X Ads MCP by AdKit

Every change is saved as a draft first, so your AI can't spend money on its own. Nothing goes live on X Ads until you approve it.

AdKit Draft Approval screen with X Ads changes waiting for approval

What you can do

Create and edit X campaigns, ad groups and ads
Upload images and videos to your ad account
Read spend, engagement and conversion results

Related MCP server: Google Ads MCP Server

Example prompts

"How much did each X campaign spend last week, and what did it get?"
"Create a website traffic campaign with this image, $20 a day. Save it as a draft."

Set up

You need an AdKit account. On first use, you sign in to AdKit and connect your X Ads account.

There are two ways to connect:

All platforms: the main AdKit connector. One connection for Google, Meta, TikTok, LinkedIn, Microsoft, Reddit, X and Pinterest. Pick this if you run ads on more than X Ads.
X Ads only: the address above. Your AI only sees the X Ads tools.

Claude (web and desktop)

All platforms: install AdKit from the Claude directory, in one click.
X Ads only: Settings → Connectors → Add custom connector → paste https://mcp.adkit.so/x-ads.

ChatGPT

All platforms: add the AdKit app, in one click.
X Ads only: Settings → Connectors → Add custom connector → paste https://mcp.adkit.so/x-ads.

Claude Code

As a plugin:

/plugin marketplace add adkit/x-ads-mcp
/plugin install x-ads@adkit-x-ads

Or as an MCP server only:

claude mcp add --transport http adkit-x-ads https://mcp.adkit.so/x-ads

Gemini CLI

gemini extensions install https://github.com/adkit/x-ads-mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adkit-x-ads": {
      "url": "https://mcp.adkit.so/x-ads"
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.adkit-x-ads]
url = "https://mcp.adkit.so/x-ads"

In Claude Code, Gemini CLI, Cursor and Codex, use https://mcp.adkit.so instead to connect all platforms.

Tools

What	Tools
Ad accounts	`x_ads_accounts_connect`, `x_ads_accounts_disconnect`, `x_ads_accounts_read`, `x_ads_accounts_update`
Campaigns	`x_ads_campaigns_create`, `x_ads_campaigns_read`, `x_ads_campaigns_update`
Ad groups	`x_ads_ad_groups_create`, `x_ads_ad_groups_read`, `x_ads_ad_groups_update`
Ads	`x_ads_ads_create`, `x_ads_ads_delete`, `x_ads_ads_read`
Results and reporting	`x_ads_results_read`
Media upload	`x_ads_upload`
Direct API requests	`x_ads_platform_api_request_mutate`

Every AdKit connector also has these tools:

Tool	What it does
`adkit_projects`	List your AdKit projects and pick one
`adkit_status`	Show the connected ad accounts
`adkit_setup`	Get the link to connect an ad account
`adkit_drafts_read`	List saved drafts, or read one
`adkit_drafts_update`	Edit a draft before it goes live
`adkit_drafts_delete`	Delete a draft
`adkit_drafts_publish`	Publish drafts after you approve them
`adkit_help`	Look up fields, limits and examples
`adkit_feedback`	Report a bug or a missing feature

FAQ

What is the X Ads MCP server?

A hosted MCP server from AdKit. It lets Claude, ChatGPT, Cursor, Codex and other AI apps work on your X Ads account: X (Twitter) campaigns, ad groups, ads and reports.

Is the X Ads MCP server free?

It is included in every AdKit plan. Plans start at $29 a month, with a 7-day free trial. See pricing.

Can my AI change my X Ads without asking me?

No. Every create, edit or pause is saved as a draft. It goes live only after you approve it, on AdKit's Draft Approval page or by telling your AI to publish it.

Do I need an API key or a developer token?

No. You sign in to AdKit in your browser and connect your X Ads account there.

Can I manage several X Ads accounts?

Yes. Connect several accounts and keep each client in its own AdKit project. How many projects you get depends on your plan.

Which AI apps does it work with?

Claude, ChatGPT, Claude Code, Gemini CLI, Cursor, Codex and any app that supports remote MCP servers with OAuth sign-in.

Other ad platforms

Support and policies

Help: adkit.so/support or contact@adkit.so
Privacy, Terms, Security, Support

Docs server

docs-server/ is a small local MCP server that answers questions about AdKit from this README: setup per AI app, hosted tools, ad platforms, example prompts and the FAQ. It needs no login and does not manage ads; for that, connect the hosted server above. Run it with npm start or the Dockerfile.

License

MIT

Available Tools

5 tools

get_example_promptsGet example promptsA

Read-onlyIdempotent

Inspect

Get example prompts that work with the hosted X Ads MCP server by AdKit, such as reporting, optimizing and launching campaigns. Use this when the user asks what to try first or what to ask the agent. Returns a Markdown list.

Inputs: no named parameters.

get_faqGet FAQA

Read-onlyIdempotent

Inspect

Get the answers to common questions about the hosted X Ads MCP server by AdKit: price, safety and approvals, API keys, several ad accounts and supported AI apps. Use this before answering such a question from memory. Returns Markdown, one heading per question.

Inputs: no named parameters.

get_setup_guideGet setup guideA

Read-onlyIdempotent

Inspect

Get the step-by-step instructions to connect one AI app to the hosted X Ads MCP server by AdKit at https://mcp.adkit.so/x-ads. Use this when the user asks how to install, add or connect AdKit in a specific app. Returns Markdown with the exact menu path, command or config snippet. For what the hosted server can do once connected, use list_hosted_tools instead.

Inputs: app (required).

list_ad_platformsList ad platformsA

Read-onlyIdempotent

Inspect

List the ad platforms AdKit supports (Google, Meta, TikTok, LinkedIn, Microsoft, Reddit, X, Pinterest) and the link to each platform's own MCP server and setup page. Use this when the user asks which ad platforms are supported or wants a server for one platform only. Returns Markdown.

Inputs: no named parameters.

list_hosted_toolsList hosted toolsA

Read-onlyIdempotent

Inspect

List the tools of the hosted X Ads MCP server by AdKit (https://mcp.adkit.so/x-ads), with one line on what each tool does. Use this to explain what an agent can do with ad accounts after connecting, such as creating campaigns, pulling performance or uploading media. Returns a Markdown table. It does not call those tools; they only run on the hosted server.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored 2026-11-13 05:20 across 5 tools

Disambiguation4/5

Each tool targets a distinct informational need (install steps, hosted capabilities, platform catalog, sample prompts, FAQ), and several descriptions explicitly redirect to the right sibling (e.g. get_setup_guide points to list_hosted_tools). The only mild overlap is between get_setup_guide and get_faq, since the FAQ also covers supported AI apps and API keys, which could tempt an agent to pick the wrong one.

Naming Consistency5/5

All five tools use a clean snake_case verb_noun pattern (get_* / list_*) with predictable semantics: get_ for a single document, list_ for enumerations. No stylistic deviations or mixed casing.

Tool Count5/5

Five tools is well-scoped for a thin onboarding/discovery surface, and each maps to a separable user question (install, capabilities, platforms, prompts, FAQ) with no filler. Nothing feels padded or conspicuously missing at the count level.

Completeness4/5

For its stated purpose — explaining and onboarding to a hosted server — the surface covers install, capability discovery, platform alternatives, first prompts, and common objections. Minor gaps exist (no dedicated tool for supported-AI-app lineup or pricing, both buried inside get_faq, and no way to verify a connection succeeded), but agents can work around them.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

ProductClankA
com.productclank
Boost posts and launch community growth campaigns from your AI assistant. OAuth, credit-billed.
Marketing Social Media
68312
https://mcp.productclank.com/mcp
AdvisorPPC
com.advisorppc
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Marketing App Automation
1
https://mcp.advisorppc.com/mcp
GrowomatA
com.growomat
Build, edit and sync Google, Microsoft, Reddit and Meta ad campaigns from your assistant.
Marketing Social Media
1131
https://mcp.growomat.com/mcp
X (Twitter) by 1Social
dev.1social
Publish and schedule tweets and threads on X (Twitter) from your AI assistant.
Social Media Marketing App Automation
1
https://mcp.1social.dev/mcp/x-twitter

Related MCP Servers

X Ads MCP Server
Social Media Marketing
Insightful-Pipe
A
license
Not graded
quality
C
maintenance
Connects X Ads (Twitter Ads) to AI assistants, enabling reporting on and creation of campaigns, line items, promoted-only posts, and cards. New campaigns start paused, and delete actions remain off by default.
Updated 24 days ago (2026-10-20 16:27 UTC)
MIT
Google Ads MCP Server
Marketing App Automation
adkit
A
license
A
quality
B
maintenance
Enables AI apps to create and edit Search, Display, Demand Gen, and Performance Max campaigns; manage keywords, negative keywords, search terms, conversions, and reporting; and save every change as a draft for approval before it goes live.
Updated 29 minutes ago (2026-11-13 05:06 UTC)
5
MIT
TikTok Ads MCP Server
Marketing Social Media
adkit
A
license
A
quality
B
maintenance
Enables AI apps to create and edit campaigns, ad groups, and ads, upload videos and images, and read spend and performance metrics, while saving every change as a draft for approval before publishing.
Updated 28 minutes ago (2026-11-13 05:06 UTC)
5
MIT
LinkedIn Ads MCP Server
Marketing Social Media
adkit
A
license
A
quality
B
maintenance
Enables AI apps such as Claude, ChatGPT, Cursor and Codex to create and edit campaigns, ad groups and ads, look up targeting values, upload images and videos, and read spend, lead and engagement reports from a connected ad account. Every change is saved as a draft that only goes live once the user approves it.
Updated 28 minutes ago (2026-11-13 05:07 UTC)
5
MIT

X Ads MCP Server

What you can do

Example prompts

Set up

Claude (web and desktop)

ChatGPT

Claude Code

Gemini CLI

Cursor

Codex

Tools

FAQ

What is the X Ads MCP server?

Is the X Ads MCP server free?

Can my AI change my X Ads without asking me?

Do I need an API key or a developer token?

Can I manage several X Ads accounts?

Which AI apps does it work with?

Other ad platforms

Support and policies

Docs server

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

X Ads MCP Server

Google Ads MCP Server

TikTok Ads MCP Server

LinkedIn Ads MCP Server