Codex · X Ads
Manage X Ads from Codex CLI with the same hosted MCP Claude uses
NotFair is a hosted X Ads MCP for OpenAI's Codex CLI. One terminal command registers the server. Codex then reads live X Ads data and stages writes for approval. 40 X Ads tools.
40 X Ads tools
Turn Codex Into Your Marketing Engine
Bring ads, search, analytics, CRM, and WordPress into your AI client. Explore each integration to see its supported actions.
Choose a platform
Choose your AI client
Install the MCP
codex mcp add NotFair-XAds --url https://notfair.co/api/mcp/notfairSign in and start asking
Audit my X Ads account and rank fixes by impact.How it works
From install to an approved X Ads change
Connect X Ads
NotFair hosts the X Ads API credentials. You authorize an existing ads account; you do not stand up an X developer app for the MCP client.
Add Codex
From any shell where Codex CLI is installed: `codex mcp add NotFair-XAds --url https://notfair.co/api/mcp/notfair`. Codex walks through OAuth and registers the MCP.
Ask, then approve writes
Codex can inspect Campaigns, line items, targeting, audiences, and promoted Tweets. Writes wait for your confirmation. uploadMedia fetches a public URL and returns a media_key. Local filesystem paths are not upload handles.
What you get
Campaigns, line items, and promoted Tweets
X does not publish a first-party Ads MCP in the public sources used here. NotFair hosts X Ads credentials and does not expose Google Ads-style impact snapshots or undo on X.
Live diagnosis
Ask what is wrong. The client reads Campaigns, line items, targeting, audiences, and promoted Tweets.
Platform-true writes
Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X.
Hosted OAuth
NotFair hosts the X Ads API credentials. You authorize an existing ads account; you do not stand up an X developer app for the MCP client.
Honest limits
uploadMedia fetches a public URL and returns a media_key. Local filesystem paths are not upload handles. X does not publish a first-party Ads MCP in the public sources used here.
X Ads tools
40 X Ads tools the client can call
The advertised count is measured from the production registrar and guarded by a drift test. The table below is a representative subset from the existing X Ads Claude landing.
| Tool | Type | Description |
|---|---|---|
runScript | read | Sandboxed JS with X Ads API fan-out. |
getAnalytics | read | Spend, impressions, engagements, CTR, CPC, CPM, conversions, ROAS. |
listCampaigns | read | Campaigns with status, objective, budget, funding instrument, and schedule. |
listLineItems | read | Line item objective, bid strategy, budget, and targeting summary. |
pauseCampaign | write | Pause an X campaign — reversible via enableCampaign. Not Google Ads undo. |
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 surface: /x-ads-mcp.
X Ads + Codex FAQ
Direct answers for operators connecting X Ads to OpenAI Codex CLI through NotFair.
Connect X Ads at notfair.co, run `codex mcp add NotFair-XAds --url https://notfair.co/api/mcp/notfair`, then ask Codex to inspect live data. Writes stay staged until you approve them.
Same hosted MCP endpoint, different client. Codex CLI calls NotFair using OpenAI's MCP support. Claude's connector and Claude Code call the same server from Anthropic's clients.
Only with explicit approval. Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X. uploadMedia fetches a public URL and returns a media_key. Local filesystem paths are not upload handles.
X does not publish a first-party Ads MCP in the public sources used here.
Related pages
Keep evaluating the same connection.
X Ads MCP
Tool surface, endpoint, and 40 X Ads tools.
X Ads Codex setup guide
One-liner install for OpenAI Codex CLI.
X Ads for Claude
Same hosted MCP endpoint on Claude's first-class landing.
X Ads for ChatGPT
ChatGPT-style workflows through an MCP-capable OpenAI client.
X Ads for Grok Bot
Marketplace install for the same hosted MCP tools.
Compare X Ads MCP servers
Sourced benchmark with public verification prompts.
X Ads write safety
Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X.