NotFairNotFair
Start now

Integration · Gemini CLI × X Ads

Run X Ads inside Gemini CLI

NotFair connects Gemini CLI to live X Ads through the same hosted MCP endpoint used across the product. Campaigns, line items, targeting, audiences, and promoted Tweets.

Supported
Hosted MCP URL https://notfair.co/api/mcp/notfair — the same endpoint as every other NotFair platform
40 X Ads tools
Writes follow this platform's real lifecycle — not Google Ads undo copied onto X Ads

Connect your X Ads account

Authorize once at notfair.co — then open Gemini CLI and start asking real questions about your account.

Connect X Ads

Setup

Connect Gemini CLI in three steps

Gemini CLI uses NotFair's hosted Streamable HTTP endpoint. 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.

  1. 1. Add the hosted MCP server

    Gemini CLI can call a remote MCP endpoint. Point it at NotFair's Streamable HTTP URL.

    {
  "mcpServers": {
    "NotFair-XAds": {
      "url": "https://notfair.co/api/mcp/notfair"
    }
  }
}

  2. 2. Authorize X Ads

    Open /connect/x-ads on notfair.co, complete the hosted connection, and select the accounts or properties Gemini CLI may use.

  3. 3. Verify with a read

    Ask Gemini CLI to list X Ads tools in this connection, excluding other platforms.

Capabilities

What Gemini CLI can do with NotFair

Read live X Ads data

Campaigns, line items, targeting, audiences, and promoted Tweets.

Counted tool surface

40 X Ads tools, measured from the production registrar and guarded by a drift test.

Hosted credentials

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.

Platform-true writes

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.

Example workflows

Prompts that lead to real account work

Wasted-spend triage

“Audit my X Ads account for the last 30 days. Rank the three highest-cost problems with evidence. Do not change anything until I approve.”

A ranked diagnosis from live tools, with staged writes that wait for approval.

Creative or delivery review

“Show frequency, spend, and delivery for the active X Ads entities. Flag creative fatigue or stalled learning. Preview any pause.”

Platform-true delivery review. Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X.

Budget shift preview

“Propose moving budget from the worst entity to the best, showing current versus proposed values. Do not execute.”

An exact proposal you can approve or reject. NotFair does not claim Google Ads impact snapshots on this platform.

Why NotFair for Gemini CLI + X Ads

The hosted MCP endpoint is the same. The X Ads contract is not. NotFair keeps tool counts, OAuth, and write limits honest for this platform.

  • 40 X Ads tools — not a vendor-wide total reused as a X Ads count
  • 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.
  • Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X.
  • Same remote endpoint in Claude, Codex, Cursor, Windsurf, Gemini CLI, and OpenClaw

FAQ

Common questions about using Gemini CLI with Google Ads through NotFair.

Yes. NotFair's hosted MCP endpoint is the same across clients. Gemini CLI speaks MCP and can call the same tools. X does not publish a first-party Ads MCP in the public sources used here.

NotFair does not copy Google Ads impact snapshots or undo onto X Ads. Preview, explicit approval, and operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on X.

NotFair advertises 40 X Ads tools.

Other integrations

Switching clients, or curious how this compares?

ChatGPT + Google Ads

NotFair connects ChatGPT to live X Ads through the same hosted MCP endpoint used across the product. Campaigns, line items, targeting, audiences, and promoted Tweets.

Claude Code + Google Ads

NotFair connects Claude Code to live X Ads through the same hosted MCP endpoint used across the product. Campaigns, line items, targeting, audiences, and promoted Tweets.

Cursor + Google Ads

NotFair connects Cursor to live X Ads through the same hosted MCP endpoint used across the product. Campaigns, line items, targeting, audiences, and promoted Tweets.