Adrex AI - Gerenciador de Campanhas de Anúncios
adrex-ai/adrex-ai
Controle Google Ads e Meta Ads via Claude/ChatGPT com 54+ ferramentas
Ver no GitHubMCP server que conecta assistentes de IA a contas Google Ads e Meta Ads, permitindo gerenciamento completo de campanhas por linguagem natural. Oferece 54+ ferramentas para criar, editar, pausar campanhas e analisar métricas em tempo real, com controles de segurança para evitar gastos indesejados.
Instalação
npx convez-ai adrex-ai/adrex-ai1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar campanhas publicitárias via linguagem natural em IA assistants
- Analisar performance e ROAS de campanhas em tempo real
- Pausar/criar campanhas e ajustar budgets sem acessar dashboards
Veredito

Ferramenta sólida e bem pensada em segurança — as campanhas são criadas pausadas por padrão, evitando acidentes com real spend. Excelente para agências e pequenos negócios que querem automação de anúncios integrada ao workflow de IA, mas requer conta paga no Adrex para conectar credenciais.
README
A tradução para o português deste README ainda está na fila.
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
License
MIT License — see LICENSE for details.