# AdLoop

Connects Google Ads, Reddit Ads, and GA4 to your coding assistant, previewing every change before adjusting campaigns or budgets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 287
- Author: kLOsk
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kLOsk/adloop
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/adloop

## What it does

AdLoop integrates paid traffic management and analytics directly into your development workflow. The server queries Google Ads, Reddit Ads, GA4, and Google Tag Manager. It helps identify discrepancies between tracking code in your repository and actual events logged by GA4.

Safety mechanics control every modification. The assistant presents an approval preview before updating an account. Drafted campaigns and ads start paused by default. In addition, conversion gap audits account for European consent rejections to prevent false tracking alerts.

Running AdLoop locally requires Python 3.11+ alongside your own Google Cloud project, though an EU-hosted cloud endpoint exists at `https://mcp.getadloop.com/mcp`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.getadloop.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http adloop https://mcp.getadloop.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add adloop -- uvx adloop
```
uvx runs the command named after the package; if the README names another one, use uvx --from adloop <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add adloop --url https://mcp.getadloop.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add adloop -- uvx adloop
```
uvx runs the command named after the package; if the README names another one, use uvx --from adloop <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adloop": {
            "url": "https://mcp.getadloop.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adloop": {
            "command": "uvx",
            "args": [
                "adloop"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from adloop <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adloop": {
            "type": "http",
            "url": "https://mcp.getadloop.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adloop": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "adloop"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from adloop <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http adloop https://mcp.getadloop.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add adloop uvx adloop
```
uvx runs the command named after the package; if the README names another one, use uvx --from adloop <command>

## When to use it
- extract search terms to add negative keywords directly from the editor
- audit tracking discrepancies between repository events and GA4 logs
- cross-reference ad destination URLs with GA4 page performance
- draft responsive search ads with mandatory user confirmation

## Example prompts
- Run `health_check` to verify connections to Google Ads and GA4
- Pull search terms from Google Ads and mark wasteful queries as negative keywords
- Compare checkout events in my code with actual GA4 incoming data

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md