Setup guide · Claude Desktop, Web & Cowork

X Ads Claude Connector

Add NotFair as a custom MCP connector inside Claude Desktop, Claude.ai Web, or Claude Cowork in under 2 minutes. Once installed, Claude reads your X (Twitter) ad accounts — campaigns, line items, promoted Tweets, and analytics — in real time and helps you diagnose, optimize, and manage them through chat.

Open Claude Connectors

Free · No credit card · 2-minute setup

How to install

Add the X Ads connector to Claude in 3 steps

Free · No credit card · No Client ID or Secret needed

1

Open Claude Connectors

Open Claude's connector settings on the web - the button below lands directly on Add custom connector. Connectors set up here apply to both Claude Desktop and Claude on the web.

Open Claude Connectors

Prefer the desktop app? Open Claude Desktop and go to Customize -> Connectors -> Add custom connector.

2

Configure the connector

Fill in the connector form:

Name

NotFair-XAds

Remote MCP Server URL

https://notfair.co/api/mcp/x_ads

Click Add.

Click ···Refresh tools list.

Verify NotFair-XAds appears in your Connectors list with all available tools.

3

Ask Claude about your ads

Open a new Claude chat and try a prompt like Audit my connected X (Twitter) ad account and tell me the 3 biggest optimization opportunities. Claude will use the NotFair connector to read your account and respond with specific, data-backed insights.

Ready to install the X connector?

Open Claude Connectors, paste the NotFair X Ads server URL, and click Add. Setup takes under 2 minutes — no Client ID or Secret needed.

FAQ — X Ads Claude Connector

Everything you need to know about installing and using the NotFair X Ads connector inside Claude.

What is the X Ads Claude Connector?

It's a custom MCP (Model Context Protocol) connector you add inside Claude Desktop, Claude.ai Web, or Claude Cowork. Once installed, Claude can read your X (Twitter) ad accounts — campaigns, line items, promoted Tweets, analytics, and targeting — in real time, then diagnose issues and propose changes you approve in chat.

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 connector reads everything X exposes through the X Ads API: campaigns, line items, promoted Tweets, targeting, and analytics.

Where does this connector work?

Anywhere Claude supports remote custom connectors: Claude Desktop, Claude.ai on the web, and Claude Cowork. If you use Claude Code or Codex, NotFair also ships as an MCP server you can wire to those CLIs.

Do I need an X Ads account?

You need an X (Twitter) account with access to at least one ad account and a valid funding instrument. NotFair connects via the standard X OAuth flow.

Do I need to write any code?

No. Setup is entirely point-and-click inside Claude Connectors. Open the Add custom connector flow, paste the NotFair X Ads server URL, click Add, and Claude opens a browser tab to sign you in — no Client ID or Secret to copy.

How long does setup take?

Under 2 minutes. Open the Add custom connector flow in Claude, paste the NotFair X Ads server URL, click Add, then sign in to X (Twitter) in the browser tab Claude opens for you and pick which ad accounts NotFair should manage.

Is the connector free?

Yes. Adding the NotFair X connector is free with no credit card. Paid plans unlock higher usage limits and team features.

Can Claude actually change my X ad accounts through the connector?

Only with your explicit approval. Claude can propose pausing campaigns or line items, adjusting budgets, or renaming entities — but every write action is shown to you first and requires confirmation. Read access is unrestricted; write access is gated.

Can I limit which X ad accounts Claude can touch?

Yes. After OAuth, NotFair shows the full list of ad accounts your X identity has access to. You pick the curated subset NotFair is allowed to read and write — only those accounts are exposed to Claude.

What data does Claude see when the connector is enabled?

Live ad-account info, campaigns, line items, promoted Tweets, targeting, and analytics (spend, impressions, engagements, CTR, CPC, CPM, conversions) — pulled directly from the X Ads API in real time.