Positronick
← Catalog
MCP Official

X Ads MCP

Official remote MCP for the X Ads API: 23 tools to read campaigns, run analytics, and create paused ads from any MCP client.

Install

via Positronick CLI

$positronick mcp install x-ads-mcp --run

Official

$claude mcp add --transport http x-ads https://ads-api.x.com/mcp --client-id YOUR_OAUTH2_CLIENT_ID --callback-port 8080

X Ads MCP is X's official hosted Model Context Protocol server at https://ads-api.x.com/mcp. Any MCP-capable client (Grok, Claude Code, or a custom agent) can connect over Streamable HTTP and use 23 Ads tools with no custom Ads API client. The agent lists accounts, campaigns, line items, and targeting; pulls account stats and reach estimates; and creates or updates campaigns, line items, targeting, and promoted posts. Auth is the user's own OAuth 2.0 token (ads.read, ads.write, offline.access), so the agent only sees ads accounts that user can access. Writes are safe by default: campaigns and line items are always created PAUSED and nothing spends until explicitly activated.
Theme