Skip to app content
X Ads
X Ads API v12 / OFFICIAL MCP CONNECTOR

X Ads MCP Server

Connect Claude, Cursor, and Codex to X Ads for $0.00 read-only analytics, live conversation keyword targeting, follower lookalikes, and PAUSED campaign staging.

Read Cost

$0.00 (Free)

Ad Spend Fee

0% (Zero Markup)

Targeting

Keywords, Followers, Tailored

Tools Exposed

9 MCP Tools

2-step direct connect: authorize X Ads -> land immediately on your ready-to-paste MCP setup ($0 read, 0% ad spend markup).1-Click Connect Deep LinkStarter Kit (.zip)Agent Spec (.md)

Connect to X Ads in 60 seconds.

One universal endpoint connects Claude, Cursor, ChatGPT, and Codex to X Ads across 43+ ad platforms, plus livestreams, search, and outbound.

Claude Desktop Remote Connector

Open Claude Desktop -> Settings -> Connectors -> Add custom connector, then paste the hosted MCP URL:

Name: Synter Ads
Remote MCP server URL:
https://mcp.synterai.com

Cursor / Claude Code

Run in terminal or add to .cursor/mcp.json:

# Claude Code CLI
claude mcp add --transport http synter-ads https://mcp.synterai.com

# Cursor .cursor/mcp.json
{"mcpServers":{"synter-ads":{"url":"https://mcp.synterai.com"}}}

X Ads MCP Tools Reference

Inspect the structured JSON-RPC tools exposed for X Ads. Read operations are 100% free ($0/mo).

9 Tools Available
Tool NameDescriptionExecution Cost
pull_x_ads_performancePull impressions, clicks, spend, engagement rate, and conversion metrics from X Ads.$0.00 (Free)
list_campaignsList X Ads campaigns, funding instruments, daily budgets, and delivery states.$0.00 (Free)
get_campaign_observationInspect pacing, delivery anomalies, and cost-per-click shifts across X campaigns.$0.00 (Free)
create_campaign_planStage keyword-targeted and follower-lookalike X Ads campaigns as PAUSED drafts.SOLO / SCALE
update_campaign_budgetAdjust X campaign budgets with directional velocity guardrails.SOLO / SCALE
pause_campaignImmediately pause underperforming X Ads campaigns.SOLO / SCALE

Battle-tested X Ads prompts.

Copy and paste these exact prompts into Claude Desktop, Cursor Composer, or your custom agent:

Prompt #1

Pull our X Ads performance over the past 14 days and compare CPC and conversion rate across keyword-targeted vs follower-lookalike line items.

Prompt #2

Stage a PAUSED X Ads keyword campaign targeting desktop engineering and CTO conversations mentioning Google Ads MCP and Meta Ads MCP.

Prompt #3

Audit X Ads daily pacing and flag any active line item with spend above $100 and zero sign-ups.

Frequently Asked Questions

Can Claude query X Ads performance for free?

Yes. Connecting your X Ads account and running pull_x_ads_performance or list_campaigns costs $0.00 with zero ad spend markup.

How are X Ads writes governed?

All new X Ads builds are staged PAUSED first via create_campaign_plan, and budget increases above workspace thresholds require explicit approval.

Ready to automate X Ads?

Connect your X Ads account and install MCP in 60 seconds. Read metrics across all 43+ ad platforms for $0.00 with 0% ad spend fee.

X Ads MCP Server | Free Read, 0% Spend Fee | Synter