Back to home

Adrex Docs

Run your Google & Meta ad accounts from any AI assistant in under a minute.

What is Adrex?

Adrex is an AI-native advertising platform for Google Ads and Meta Ads. It ships an open-source MCP (Model Context Protocol) server, so you can manage campaigns directly from any MCP client — Claude Code, Cursor, Codex, Gemini, Claude Desktop, and more — using plain language. Connect your accounts once in the dashboard, drop in one API key, and you get 54 tools for campaigns, reporting, keywords, and targeting. No SDK, no developer tokens, no OAuth juggling in your client.

Quick start (4 steps)

  1. 1. Connect your ad accounts

    Sign up at adrex.ai, open Settings → API Connections, and connect Google and/or Meta with one click. Credentials stay with Adrex — your AI client never sees them.

  2. 2. Generate an API key

    Go to Settings → MCP / API Key and click Generate. This key links your AI client to the accounts you just connected.

  3. 3. Add Adrex to your AI client

    Paste the one-line command or config for your client (see below), with your API key.

  4. 4. Just ask

    “How are my campaigns doing?” → “Pause the underperformers and shift budget to the winners.” Adrex executes it via the API.

Add Adrex to your AI client

Adrex is a standard stdio MCP server, so any MCP client works. Replace YOUR_API_KEY with the key from Settings.

Claude Code

claude mcp add -s user adrex-ai -e ADREX_API_KEY=YOUR_API_KEY -- npx -y adrex-ai

Gemini CLI

gemini mcp add adrex-ai -e ADREX_API_KEY=YOUR_API_KEY -- npx -y adrex-ai

Cursor / Claude Desktop / OpenClaw (JSON)

Add to Cursor's ~/.cursor/mcp.json (or .cursor/mcp.json per project), or Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "adrex-ai": {
      "command": "npx",
      "args": ["-y", "adrex-ai"],
      "env": { "ADREX_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Codex

Add to ~/.codex/config.toml (Codex uses TOML, not JSON):

[mcp_servers.adrex-ai]
command = "npx"
args = ["-y", "adrex-ai"]
env = { ADREX_API_KEY = "YOUR_API_KEY" }

Any other MCP client

Cline, Windsurf, Zed, Continue, and others: point the client at command npx -y adrex-ai with environment variable ADREX_API_KEY set to your key.

Try it — example prompts

  • “List my Google and Meta campaigns with spend, CTR, and ROAS.”
  • “Which campaigns are over their target CPA this week?”
  • “Pause every ad set with frequency above 4.”
  • “Increase the budget on my top-ROAS campaign by 15%.”
  • “Add these 10 negative keywords to my Search campaign.”
  • “Show a 30-day time series for campaign X by device.”

What you can do (54 tools)

Google Ads

Campaigns, ad groups, responsive search ads, keywords & negatives, budgets, performance, time series, breakdowns, auction insights.

Meta Ads

Campaigns, ad sets, ads, targeting & interests, custom audiences, Pages, performance, time series, breakdowns.

Cross-platform

See connected platforms and unified usage in one place. TikTok & LinkedIn coming soon.

On the platform (paid)

Autonomous optimization agent, AI Creative Studio, budget rules, A/B experiments, competitor intelligence.

Safety & permissions

  • New campaigns and ads are created paused by default — nothing spends until you say so.
  • Destructive actions (delete) and budget changes are gated server-side, and every change is logged.
  • OAuth tokens are encrypted at rest and never exposed to your AI client — the client only holds your Adrex API key.
  • Revoke access anytime: disconnect a platform or delete your API key in Settings.

Plans & limits

The MCP server is free and open source. Hosted usage is metered by monthly tool calls: Free (100), Starter (2,000), Pro (20,000), Agency (unlimited). Higher tiers add the autonomous agent, creative tools, experiments, and competitor intelligence. See pricing.

Troubleshooting

  • “No API key” / not connecting: make sure ADREX_API_KEY is set in your client config and restart the client.
  • “Invalid or expired key”: regenerate the key in Settings → MCP and update your config.
  • “No accounts found”: connect Google/Meta first in Settings → API Connections.
  • Quota reached: you've hit your monthly tool-call limit — upgrade your plan in Settings.
  • Behind a corporate proxy: the server honors HTTP_PROXY / HTTPS_PROXY.

Links