X Ads MCP server
Hosted X Ads MCP server
NotFair ships a hosted Model Context Protocol server at https://notfair.co/api/mcp/x_ads. Drop the generic config below into any MCP-compatible client so your AI can diagnose X (Twitter) ad accounts and draft fixes — auth via OAuth or Bearer token.
Free · OAuth 2.0 · No credit card
New to MCP? Read the spec at modelcontextprotocol.io.
Generic MCP config
Two configs that work in any MCP client
For client-specific walkthroughs (Claude.ai, Claude Code, Codex), see the per-client setup guides linked below.
OAuth 2.0 (recommended)
Drop into ~/.cursor/mcp.json (Cursor), the Cline settings JSON, or any client that takes the standard MCP config schema. The client opens a browser for sign-in.
{
"mcpServers": {
"NotFair-XAds": {
"url": "https://notfair.co/api/mcp/x_ads"
}
}
}Tools exposed
What your AI client can read and change
Read tools provide live ad-account context. Write tools propose changes — every write requires explicit human approval before it hits the X Ads API.
| Tool | Type | What it does |
|---|---|---|
runScript | Read | Sandboxed JS with X Ads API fan-out — fan out 20 calls in one pass for audits and analysis. |
getAnalytics | Read | Performance analytics with breakdowns: spend, impressions, engagements, CTR, CPC, CPM, conversions. |
listCampaigns | Read | List campaigns with status, objective, budget, funding instrument, and schedule. |
listLineItems | Read | Line item details: objective, bid strategy, daily/total budget, targeting summary. |
listPromotedTweets | Read | Promoted Tweets with status, parent line item/campaign, and creative envelope. |
getAdAccount | Read | Account snapshot: currency, timezone, funding instruments, amount spent, status. |
| and more | ||
Ready to wire up your client?
Sign in to NotFair, link your X ad accounts, then paste a config above into your MCP client.
FAQ — NotFair X MCP server
Common questions about authenticating, configuring, and using the NotFair X Ads MCP server.
What is the NotFair X Ads MCP server?
It's a hosted Model Context Protocol server that exposes your X (Twitter) ad accounts to MCP-compatible AI clients. Read tools provide live campaign context for diagnosis; write tools propose fixes that you approve in chat.
Which MCP clients are supported?
Any client that speaks the MCP Streamable HTTP transport — Claude.ai (Web, Desktop, Cowork), Claude Code, OpenAI Codex CLI, Hermes Agent, OpenClaw, Cursor, Cline, and custom MCP clients. The server URL is the same; only the client-side config differs.
Do I need to self-host anything?
No. The X Ads MCP server is hosted at https://notfair.co/api/mcp/x_ads. You just point your client at it and authenticate.
How does authentication work?
OAuth 2.0 with PKCE is the recommended flow — Claude.ai and Codex run it automatically. For clients that don't support OAuth, you can use a Bearer token via the Authorization header. Generate either at notfair.co/connect/x-ads.
Is the MCP server free?
Yes. Connecting to NotFair's X MCP is free with no credit card. Paid plans unlock higher usage limits and team features.
Can the AI write to my X ad accounts through this server?
Only with your explicit approval. Write tools propose changes (pause campaigns, adjust budgets, rename entities, etc.), the client surfaces them, and you confirm before anything hits the X Ads API. Read access is unrestricted; write access is gated.
How is an X Ads account structured?
X Ads runs everything under a single ad account: funding instruments pay for campaigns, campaigns hold line items, and line items deliver promoted Tweets. The MCP exposes everything X surfaces through the X Ads API: campaigns, line items, promoted Tweets, targeting, and analytics.
Per-client setup guides
Walkthroughs for each supported client.
X Ads Claude Connector setup guide
Install NotFair's X connector inside Claude.ai Web, Desktop, or Cowork.
X Ads Claude Code plugin setup guide
Install the NotFair plugin in Claude Code via the NotFair marketplace for X Ads.
X Ads Codex MCP setup guide
One-line install of the NotFair X MCP for OpenAI's Codex CLI.