Skip to content
X Ads MCP

X Ads MCP

by X Corp.
Released
3 views
Proprietary
Docs
Payments & Commerce

Summary

X's official remote MCP server for advertisers — 23 tools to read campaign data, run analytics and create or activate campaigns from any MCP client.

Features

  • Remote server at https://ads-api.x.com/mcp — nothing to install
  • 23 tools across reads, analytics, targeting search and writes
  • Campaign, line item, funding instrument and promoted post reads
  • Account statistics and campaign reach estimates
  • Ten write tools that create and activate live campaigns
  • Scoped OAuth 2.0: ads.read, ads.write and offline.access

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "X Ads MCP" tools will be available.
{
  "mcpServers": {
    "x-ads-mcp": {
      "command": "claude",
      "args": [
        "mcp",
        "add",
        "x-ads",
        "https://ads-api.x.com/mcp",
        "--transport",
        "http",
        "--client-id",
        "YOUR_OAUTH2_CLIENT_ID",
        "--callback-port",
        "8080"
      ]
    }
  }
}

Description

X's official remote Model Context Protocol server for the X Ads API, launched 24 August 2026. It is built into X's own API gateway rather than shipped as a package, so there is nothing to install locally: point an MCP client at https://ads-api.x.com/mcp and authenticate over OAuth 2.0.

The server exposes 23 tools in four groups. Accounts and reads list and fetch campaigns, line items, funding instruments, targeting criteria, promoted posts and account posts. Analytics covers account statistics and campaign reach estimates. Targeting search discovers interests and locations. Writes — ten of the 23 tools — create and activate campaigns and line items, manage targeting, and create ad posts.

That write capability is the thing to plan around: those tools act on live advertising accounts and spend real money. Access is scoped, so the safe default is to grant ads.read and offline.access only, and add ads.write deliberately. In Claude Code the client requests every advertised scope by default; restricting it means editing ~/.claude.json and setting "scopes": "ads.read offline.access" by hand.

Setup runs through the existing X developer console. Register an app with Read/Write permission as a Native App type, set the callback URI to http://localhost:8080/callback, copy the OAuth 2.0 Client ID (not the numeric app ID), enable Ads Project access, and confirm your X account can reach at least one ads account. Native apps use PKCE; confidential clients pass a secret via environment variable.

Transport is HTTP POST carrying JSON-RPC with SSE-framed responses, so it works with Grok, Claude, and custom agents built on the MCP SDKs. X joins Meta, Pinterest, TikTok and Snapchat in shipping an advertiser-facing MCP server.

Covered in the Weekly

Related MCP Servers

MCP: Aave MCP

by Aave

New

Aave's official MCP server: live V3 and V4 markets, wallet positions and health factor, DAO governance, and unsigned transactions your own wallet signs.

Payments & Commerce
2 views

MCP: Xero MCP Server

by Xero

Featured

Official Xero MCP server that lets an agent read and write a real accounting ledger — invoices, contacts, payments, payroll timesheets and financial reports — over the Xero API.

Payments & Commerce
4 views

MCP: Modern Treasury MCP Server

by Modern Treasury

Modern Treasury's official MCP server, built on Code Mode: the agent writes TypeScript against the payments SDK and runs it in a sandbox instead of calling one tool per endpoint.

Payments & Commerce
5 views
Browse all MCP servers →