Adrex AI

by adrex-ai

268 downloads

Not rated

GitHub

About

Open-source MCP server for Google Ads and Meta Ads. Create campaigns, pull reports, and manage keywords & targeting in plain English from Claude, Cursor, or Codex.

Details

Author: adrex-ai
Downloads: 268
Categories: Other, Marketing, Automation

- Connects Google Ads and Meta Ads to any MCP client
- Manage campaigns, keywords, audiences, and targeting via plain English
- Every campaign and ad is created paused by default
- Spend-starting actions prompt a warning before execution
- Read-only operations run freely without risk
- Ad account tokens remain on Adrex’s servers, never in the client

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Adrex AI

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Add Adrex AI to your MCP client using a command like claude mcp add -s user adrex-ai -e ADREX_API_KEY=<key> -- npx -y adrex-ai. Obtain a free API key at https://adrex.ai, then connect your ad accounts once via OAuth. After setup, you can issue natural language commands such as "Show my Google Ads performance for the last 7 days" or "Pause the campaign with the lowest ROAS."

`google_ads_list_accounts`

List all accessible Google Ads accounts

`google_ads_list_campaigns`

List all campaigns for a Google Ads account with performance metrics

`google_ads_get_campaign`

Get detailed information and metrics for a specific Google Ads campaign

`google_ads_create_search_campaign`

Create a new Google Ads Search campaign. Campaign is created PAUSED for safety — no money will be spent until you resume it.

`google_ads_update_campaign`

Update a Google Ads campaign's name, budget, or bidding strategy

`google_ads_pause_campaign`

Pause a Google Ads campaign — stops ad delivery immediately

`google_ads_resume_campaign`

Resume a paused Google Ads campaign — this will start spending your budget

`google_ads_delete_campaign`

Permanently remove a Google Ads campaign — this action is IRREVERSIBLE

`google_ads_list_ad_groups`

List all ad groups for a Google Ads campaign with performance metrics

`google_ads_create_ad_group`

Create a new ad group within a Google Ads campaign

`google_ads_update_ad_group`

Update a Google Ads ad group's name, bid, or status

`google_ads_pause_ad_group`

Pause a Google Ads ad group

`google_ads_delete_ad_group`

Permanently remove a Google Ads ad group — IRREVERSIBLE

`google_ads_list_ads`

List all ads in a Google Ads ad group with performance metrics

`google_ads_create_responsive_search_ad`

Create a Responsive Search Ad with multiple headlines and descriptions. Ad is created PAUSED for review.

`google_ads_pause_ad`

Pause a Google Ads ad

`google_ads_enable_ad`

Enable a paused Google Ads ad — it will start serving

`google_ads_delete_ad`

Permanently remove a Google Ads ad — IRREVERSIBLE

`google_ads_list_keywords`

List keywords in a Google Ads ad group with quality score and performance metrics

`google_ads_add_keywords`

Add keywords to a Google Ads ad group with specified match types

`google_ads_add_negative_keywords`

Add negative keywords to a Google Ads campaign to exclude irrelevant searches

`google_ads_pause_keyword`

Pause a keyword in a Google Ads ad group

`google_ads_remove_keyword`

Permanently remove a keyword from a Google Ads ad group — IRREVERSIBLE

`google_ads_campaign_performance`

Get performance summary across all Google Ads campaigns with spend, clicks, conversions, and ROAS

`google_ads_time_series`

Get daily performance time series for a Google Ads campaign

`google_ads_breakdowns`

Get campaign breakdowns by device or network for a Google Ads campaign

`google_ads_auction_insights`

Get competitive auction insights showing how you compare against other advertisers

`google_ads_get_budget`

Get budget details for a Google Ads campaign

`meta_ads_list_accounts`

List all accessible Meta (Facebook) ad accounts

`meta_ads_list_campaigns`

List all campaigns for a Meta ad account with performance metrics

`meta_ads_get_campaign`

Get detailed information and metrics for a specific Meta campaign

`meta_ads_create_campaign`

Create a new Meta Ads campaign. Created PAUSED for safety — no money spent until you activate it.

`meta_ads_update_campaign`

Update a Meta campaign's name, budget, or status

`meta_ads_pause_campaign`

Pause a Meta campaign — stops ad delivery immediately

`meta_ads_resume_campaign`

Activate a paused Meta campaign — this will start spending your budget

`meta_ads_delete_campaign`

Permanently delete a Meta campaign — IRREVERSIBLE

`meta_ads_list_ad_sets`

List all ad sets for a Meta campaign with targeting and metrics

`meta_ads_create_ad_set`

Create a new ad set in a Meta campaign with targeting options

`meta_ads_update_ad_set`

Update a Meta ad set's name, budget, or status

`meta_ads_pause_ad_set`

Pause a Meta ad set

`meta_ads_delete_ad_set`

Permanently delete a Meta ad set — IRREVERSIBLE

`meta_ads_list_ads`

List all ads in a Meta ad set with creative details and metrics

`meta_ads_create_ad`

Create a new Meta ad with creative (image, copy, link). Ad is created PAUSED for review.

`meta_ads_pause_ad`

Pause a Meta ad

`meta_ads_enable_ad`

Activate a paused Meta ad — it will start serving

`meta_ads_delete_ad`

Permanently delete a Meta ad — IRREVERSIBLE

`meta_ads_search_interests`

Search Meta's targeting interests and behaviors for audience building

`meta_ads_list_audiences`

List custom audiences for a Meta ad account

`meta_ads_list_pages`

List Facebook pages you manage (needed for creating ads)

`meta_ads_update_targeting`

Update targeting settings on a Meta ad set (age, gender, countries, interests)

`meta_ads_campaign_performance`

Get performance summary across all Meta campaigns with spend, clicks, and conversions

`meta_ads_time_series`

Get daily performance time series for a Meta campaign

`meta_ads_breakdowns`

Get campaign breakdowns by device, platform, placement, age, or gender

`list_connected_platforms`

Check which ad platforms are configured and ready to use

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "adrex-ai": {
        "command": "npx",
        "args": [
            "-y",
            "adrex-ai"
        ],
        "env": {
            "ADREX_API_KEY": "<YOUR_ADREX_API_KEY>"
        }
    }
}

Adrex AI — Google Ads & Meta Ads for your AI assistant

Adrex AI is an open-source MCP server that connects Google Ads and Meta Ads to Claude, Cursor, Codex, or any MCP client. Manage campaigns, reporting, keywords, audiences, and targeting in plain English — no dashboards. ### Setup ```bash claude mcp add -s user adrex-ai -e ADREX_API_KEY=<key> -- npx -y adrex-ai Get a free API key at https://adrex.ai. Connect your ad accounts once via OAuth — tokens stay on Adrex's servers, never in the client. What you can do - "Show my Google Ads performance for the last 7 days" - "Pause the campaign with the lowest ROAS" - "Create a Meta campaign for our summer sale, $50/day" (created paused for review) Safety first Every campaign and ad is created paused, spend-starting actions warn first, and read operations run freely.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

google_ads_list_accounts

google_ads_list_campaigns

google_ads_get_campaign

google_ads_create_search_campaign

google_ads_update_campaign

google_ads_pause_campaign

google_ads_resume_campaign

google_ads_delete_campaign

google_ads_list_ad_groups

google_ads_create_ad_group

google_ads_update_ad_group

google_ads_pause_ad_group

google_ads_delete_ad_group

google_ads_list_ads

google_ads_create_responsive_search_ad

google_ads_pause_ad

google_ads_enable_ad

google_ads_delete_ad

google_ads_list_keywords

google_ads_add_keywords

google_ads_add_negative_keywords

google_ads_pause_keyword

google_ads_remove_keyword

google_ads_campaign_performance

google_ads_time_series

google_ads_breakdowns

google_ads_auction_insights

google_ads_get_budget

meta_ads_list_accounts

meta_ads_list_campaigns

meta_ads_get_campaign

meta_ads_create_campaign

meta_ads_update_campaign

meta_ads_pause_campaign

meta_ads_resume_campaign

meta_ads_delete_campaign

meta_ads_list_ad_sets

meta_ads_create_ad_set

meta_ads_update_ad_set

meta_ads_pause_ad_set

meta_ads_delete_ad_set

meta_ads_list_ads

meta_ads_create_ad

meta_ads_pause_ad

meta_ads_enable_ad

meta_ads_delete_ad

meta_ads_search_interests

meta_ads_list_audiences

meta_ads_list_pages

meta_ads_update_targeting

meta_ads_campaign_performance

meta_ads_time_series

meta_ads_breakdowns

list_connected_platforms

Claude Desktop / Cursor

McpServers

Adrex AI — Google Ads & Meta Ads for your AI assistant

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Filesystem

EverArt

`google_ads_list_accounts`

`google_ads_list_campaigns`

`google_ads_get_campaign`

`google_ads_create_search_campaign`

`google_ads_update_campaign`

`google_ads_pause_campaign`

`google_ads_resume_campaign`

`google_ads_delete_campaign`

`google_ads_list_ad_groups`

`google_ads_create_ad_group`

`google_ads_update_ad_group`

`google_ads_pause_ad_group`

`google_ads_delete_ad_group`

`google_ads_list_ads`

`google_ads_create_responsive_search_ad`

`google_ads_pause_ad`

`google_ads_enable_ad`

`google_ads_delete_ad`

`google_ads_list_keywords`

`google_ads_add_keywords`

`google_ads_add_negative_keywords`

`google_ads_pause_keyword`

`google_ads_remove_keyword`

`google_ads_campaign_performance`

`google_ads_time_series`

`google_ads_breakdowns`

`google_ads_auction_insights`

`google_ads_get_budget`

`meta_ads_list_accounts`

`meta_ads_list_campaigns`

`meta_ads_get_campaign`

`meta_ads_create_campaign`

`meta_ads_update_campaign`

`meta_ads_pause_campaign`

`meta_ads_resume_campaign`

`meta_ads_delete_campaign`

`meta_ads_list_ad_sets`

`meta_ads_create_ad_set`

`meta_ads_update_ad_set`

`meta_ads_pause_ad_set`

`meta_ads_delete_ad_set`

`meta_ads_list_ads`

`meta_ads_create_ad`

`meta_ads_pause_ad`

`meta_ads_enable_ad`

`meta_ads_delete_ad`

`meta_ads_search_interests`

`meta_ads_list_audiences`

`meta_ads_list_pages`

`meta_ads_update_targeting`

`meta_ads_campaign_performance`

`meta_ads_time_series`

`meta_ads_breakdowns`

`list_connected_platforms`