X Ads MCP Server
Use Claude for X Ads — live data, 2-minute setup.
NotFair is an X Ads MCP server for Claude. Connect once and Claude gets live access to your X (Twitter) campaigns, line items, promoted Tweets, and spend — then helps you diagnose fatigue, optimize budgets, and manage approved changes through natural conversation.
Turn Claude Into Your Marketing Engine
Connect NotFair to Claude, OpenClaw, Codex, Cursor, or Hermes and operate Google Ads or Meta Ads from a chat - diagnose, draft fixes, and approve every write.
Choose a platform
Choose your AI client
Add a custom connector
Name
NotFair-XAdsRemote MCP server URL
https://notfair.co/api/mcp/x_adsSign in and start asking
Add, Claude opens a sign-in flow. Sign in with NotFair and you are all set. Try: Audit my Google Ads account and rank fixes by impact.How it works
Connect X Ads to Claude in 2 minutes.
Add NotFair to your MCP config
Paste the config snippet into Claude Desktop, Claude Code, or Claude Cowork. One entry, no API keys needed at this step.
Connect your X Ads account
OAuth in one click at notfair.co. Read permissions only until you approve a specific change — your funding instruments and ad accounts stay safe.
Ask Claude anything about your campaigns
Try: "Which line items are losing efficiency and what should I rotate?" Claude pulls live X data and answers with specifics — no CSV exports, no copy-paste.
What you get
Claude AI for X Ads — what it actually does.
Once connected, Claude has live access to your X (Twitter) ad accounts. No more exporting CSVs from Ads Manager, copying tables into chat, or working from screenshots. Ask a question, get a specific answer backed by real data.
Campaign diagnosis in natural language
Ask Claude what is wrong. It checks campaign structure, line item delivery, targeting, creative fatigue, and budget pacing — then gives you a prioritized fix list.
Find the issues you did not know to ask for
Mature accounts often have clear problems hiding in targeting, bid strategy, and budget allocation. Asking "what should I fix?" surfaces them immediately.
Every change is reviewable
NotFair never commits a change without your explicit approval. Claude shows you what it wants to do, you say yes or no. Human always in control.
Works where you already work
Claude Desktop for solo marketers. Claude Code for developers managing campaigns. Claude Cowork for teams. One MCP config, all three clients.
MCP tools exposed
What Claude can read and change.
NotFair exposes a focused set of MCP tools for X. Read tools give Claude live account context across your X (Twitter) campaigns. Write tools let Claude propose changes — each requiring your explicit approval before execution.
| Tool | Type | What it does |
|---|---|---|
runScript | Read | Sandboxed JS with X Ads API fan-out — every analytical read across your X campaigns goes through this one tool |
getAnalytics | Read | Performance with breakdowns: spend, impressions, engagements, CTR, CPC, CPM, conversions, ROAS |
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 |
pauseCampaign | Write | Pause an X campaign — reversible via enableCampaign |
pauseLineItem | Write | Pause a line item without touching its parent campaign |
updateCampaignBudget | Write | Update daily or total budget on an X campaign |
createCampaign | Write | Launch a new X campaign with objective, budget, and schedule |
Full tool reference at /x-ads-mcp.
FAQ — X Ads and Claude
Common questions from MCP builders and marketers setting up the Claude AI X Ads workflow.
Add NotFair to your MCP config (one JSON snippet), connect your X Ads account via OAuth at notfair.co, and Claude immediately gains live access to your X (Twitter) campaigns. You can then ask Claude what is wrong, why performance changed, what to fix next, or to draft approved budget, targeting, and creative changes — all in natural conversation.
Yes. NotFair is a standard MCP server, so it works with any MCP-compatible Claude client. Add the same config snippet to Claude Desktop settings, your Claude Code MCP config, or Claude Cowork — it works identically in all three.
Claude gets live access to campaign performance, line item targeting and budgets, promoted Tweet creative, spend, impressions, engagements, CPM, CTR, and conversions on X (Twitter). It reads your actual ad account data in real time — no exports or manual uploads needed.
Yes, but only with your explicit approval at each step. Claude can propose budget changes, pause campaigns or line items, update creative, and launch new campaigns — but every action is shown to you before it executes. You review and confirm. NotFair also logs every change so you can track impact.
NotFair is an independent product built on Anthropic's open Model Context Protocol (MCP) standard and the X Ads API. It is not an official X product. MCP is the open standard Anthropic created for connecting AI to external tools — any developer can build MCP servers, and NotFair is one focused on ad platforms.
Under 2 minutes. Paste one JSON snippet into your MCP config, open notfair.co, click Connect X Ads, complete the OAuth flow. That's it — Claude can now access your X ad accounts.
No coding required. Editing a JSON config file is the most technical step — it's copying and pasting one snippet. The rest is standard X OAuth and talking to Claude in plain English.
Related pages
Explore the full NotFair workflow for X Ads and Claude.