adrex-ai

Adrex AI

MCP server for Google Ads & Meta Ads

Manage your ad campaigns from Claude Code, Cursor, Codex, Gemini, or any MCP client.

Quick Start | 54 Tools | Platform | Discord

What is Adrex AI?

Adrex AI is an MCP (Model Context Protocol) server that connects AI assistants to your Google Ads and Meta Ads accounts. Instead of navigating complex dashboards, you manage campaigns through natural language.

You: "Show me my Google Ads performance for the last 7 days"
Claude: [calls google_ads_campaign_performance] → table with spend, clicks, CTR, ROAS

You: "Pause the campaign with the lowest ROAS"
Claude: [calls google_ads_pause_campaign] → campaign paused, no more spend

You: "Create a Meta campaign for our summer sale, $50/day budget"
Claude: [calls meta_ads_create_campaign] → campaign created PAUSED for your review

You connect your ad accounts once in the Adrex dashboard (secure OAuth — your tokens stay on our servers, never in the MCP client), then drive everything from your AI assistant with a single API key.

Safety First

These tools operate on real ad accounts that spend real money:

• All campaigns and ads are created PAUSED — no spend until you explicitly resume
• Destructive and spend-starting actions return clear warnings
• Read operations (metrics, lists) run freely without side effects

Quick Start

1. Get your API key

Sign up at adrex.ai, connect your Google/Meta ad accounts in Settings, and generate an API key.

2. Add the server to your AI assistant

Adrex ships a standard stdio MCP server, so it works with any MCP client. Pick yours below — every config points at npx -y adrex-ai with your ADREX_API_KEY.

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

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json), Cursor (~/.cursor/mcp.json global or .cursor/mcp.json per-project), Gemini CLI (~/.gemini/settings.json), or any client using the JSON mcpServers format:

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

Codex (~/.codex/config.toml) — note 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, …): point it at command npx -y adrex-ai with env ADREX_API_KEY set to your key.

That's it — no SDK setup, no developer tokens, no OAuth juggling. The server forwards each request to the Adrex backend, which uses the ad-account credentials you connected in the dashboard.

Behind a corporate proxy? v1.0.4+ automatically routes through HTTP_PROXY / HTTPS_PROXY.

Tools

Google Ads (28 tools)

Campaigns

Tool	Description
google_ads_list_accounts	List all accessible Google Ads accounts
google_ads_list_campaigns	List campaigns with performance metrics
google_ads_get_campaign	Get detailed campaign info and metrics
google_ads_create_search_campaign	Create a Search campaign (created PAUSED)
google_ads_update_campaign	Update name, budget, or bidding strategy
google_ads_pause_campaign	Pause a campaign
google_ads_resume_campaign	Resume a paused campaign
google_ads_delete_campaign	Permanently remove a campaign

Ad Groups

Tool	Description
google_ads_list_ad_groups	List ad groups with metrics
google_ads_create_ad_group	Create an ad group with CPC bid
google_ads_update_ad_group	Update name, bid, or status
google_ads_pause_ad_group	Pause an ad group
google_ads_delete_ad_group	Remove an ad group

Ads

Tool	Description
google_ads_list_ads	List ads with headlines, URLs, and metrics
google_ads_create_responsive_search_ad	Create RSA with headlines & descriptions
google_ads_pause_ad	Pause an ad
google_ads_enable_ad	Enable a paused ad
google_ads_delete_ad	Remove an ad

Keywords

Tool	Description
google_ads_list_keywords	List keywords with quality score and metrics
google_ads_add_keywords	Add keywords (BROAD, PHRASE, EXACT)
google_ads_add_negative_keywords	Add negative keywords to a campaign
google_ads_pause_keyword	Pause a keyword
google_ads_remove_keyword	Remove a keyword

Reporting

Tool	Description
google_ads_campaign_performance	Performance summary across all campaigns
google_ads_time_series	Daily metrics over a date range
google_ads_breakdowns	Breakdowns by device or network
google_ads_auction_insights	Competitive auction metrics
google_ads_get_budget	Campaign budget details

Meta Ads (25 tools)

Campaigns

Tool	Description
meta_ads_list_accounts	List all Meta ad accounts
meta_ads_list_campaigns	List campaigns with metrics
meta_ads_get_campaign	Get detailed campaign info
meta_ads_create_campaign	Create a campaign (created PAUSED)
meta_ads_update_campaign	Update name, budget, or status
meta_ads_pause_campaign	Pause a campaign
meta_ads_resume_campaign	Activate a paused campaign
meta_ads_delete_campaign	Delete a campaign

Ad Sets

Tool	Description
meta_ads_list_ad_sets	List ad sets with targeting and metrics
meta_ads_create_ad_set	Create ad set with targeting options
meta_ads_update_ad_set	Update name, budget, or status
meta_ads_pause_ad_set	Pause an ad set
meta_ads_delete_ad_set	Delete an ad set

Ads

Tool	Description
meta_ads_list_ads	List ads with creative details and metrics
meta_ads_create_ad	Create ad with copy, image, and CTA
meta_ads_pause_ad	Pause an ad
meta_ads_enable_ad	Activate a paused ad
meta_ads_delete_ad	Delete an ad

Targeting & Audiences

Tool	Description
meta_ads_search_interests	Search targeting interests and behaviors
meta_ads_list_audiences	List custom audiences
meta_ads_list_pages	List your Facebook pages
meta_ads_update_targeting	Update ad set targeting

Reporting

Tool	Description
meta_ads_campaign_performance	Performance summary across campaigns
meta_ads_time_series	Daily performance time series
meta_ads_breakdowns	Breakdowns by device, platform, age, gender

Cross-Platform (1 tool)

Tool	Description
list_connected_platforms	Check which platforms are connected and your usage

Use Cases

Performance Review

"How are my Google Ads campaigns performing this month? Show me the ones with ROAS below 2x."

Campaign Management

"Create a new Meta traffic campaign called 'Summer Sale 2026' with a $75/day budget targeting ages 25-45 in the US."

Keyword Optimization

"Show me keywords in my 'Brand Terms' ad group. Pause any with quality score below 5."

Budget Control

"Increase the budget on my top-performing campaign by 20% and pause the one that's losing money."

Want More?

The MCP server gives you full campaign management from chat. The Adrex AI Platform adds:

• AI Campaign Agent — autonomous optimization with guardrails and rollback
• Creative Studio — AI-generated ad copy and images
• A/B Testing — native platform experiments
• Competitor Intelligence — track competitor ads across Google and Meta
• Budget Rules Engine — automated rules with natural language parsing
• Visual Dashboard — interactive charts, breakdowns, and time-series

Links

• Adrex AI Platform
• Documentation
• Discord Community

License

MIT License — see LICENSE for details.

Built by the team behind Adrex AI