AdLoop

Name: AdLoop
Author: kLOsk

@kLOsk

Repository

About AdLoop

The AI command center for Google Ads, GA4, and tracking code.

#google-ads #analytics #ads

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "adloop": {
      "command": "/absolute/path/to/adloop/.venv/bin/python",
      "args": [
        "-m",
        "adloop"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is AdLoop?

AdLoop is an MCP server that gives your AI assistant read + write access to Google Ads and GA4 — with safety guardrails that prevent accidental spend. It exists because managing Google Ads alongside your code is a mess, and it solves problems like diagnosing conversion drops, wasted ad spend, tracking mismatches, and landing page issues. Designed for developers and marketers who work with Google Ads and GA4.

How to use AdLoop?

You can use AdLoop as a hosted cloud version (connect Google in two clicks at getadloop.com, free during beta) or self-host it by running pip install adloop and then adloop init to set up your own Google Cloud project and developer token. Both versions run the same 43 tools. The cloud version works with claude.ai, ChatGPT, Claude Code, Cursor, and Gemini; the self-hosted version works with Claude Code, Cursor, Claude Desktop, or any local MCP client.

Key features of AdLoop

43 tools covering diagnostics, GA4 reads, Google Ads reads, cross-references, tracking, planning, and writes
Cross-reference tools that join Ads clicks, GA4 sessions, and conversions in one query
Safety guardrails: draft → preview → confirm workflow; all new campaigns start paused
GDPR consent awareness — automatically accounts for 30-70% EU cookie rejection rates
Orchestration rules for AI to combine tools correctly (marketing workflows, safety protocols)
Both cloud (hosted, EU servers, GDPR-first) and self-hosted (100% on your machine)

Use cases of AdLoop

Diagnose a conversion drop by cross-referencing Ads clicks, GA4 sessions, and conversion events in one query.
Pull search terms, identify irrelevant queries, and add negative keywords directly from your IDE.
Compare event names in your codebase against what GA4 actually receives to find tracking mismatches.
Draft responsive search ads, create campaigns, and add keywords through natural language with preview before applying.
Join ad final URLs with GA4 page-level data to find landing pages with paid traffic but zero conversions.

FAQ from AdLoop

What is the difference between AdLoop Cloud and self-hosted?

Cloud requires no Google Cloud project or developer token; connect in two clicks. Self-hosted requires your own Google Cloud project and Ads developer token. Cloud works with claude.ai, ChatGPT, etc.; self-hosted works with local MCP clients. Cloud data flows through EU servers (Germany, GDPR-first, DPA included); self-hosted data stays on your machine. Cloud is free during beta; self-hosted is free forever (MIT license).

How do I get started with AdLoop?

For cloud, visit getadloop.com and connect Google in two clicks. For self-hosted, run pip install adloop or clone the repo and run uv sync && uv run adloop init. Then configure your Google Ads and GA4 credentials.

What tools does AdLoop provide?

43 tools including: health check, GA4 reports (account summaries, realtime, tracking events), Ads reads (campaign, ad, keyword, search terms, negative keywords, recommendations, PMax, assets, audiences, GAQL), cross-reference tools (campaign conversions, landing page analysis, attribution check), tracking tools (validate tracking, generate tracking code), planning tools (discover keywords, estimate budget), and Ads write tools (draft campaign, update campaign, draft ad group, draft RSA, callouts, snippets, image assets, keywords, negative keywords, pause/enable/remove entities, confirm and apply). All write operations follow a draft→preview→confirm workflow.

Is there a free version of AdLoop?

Both cloud and self-hosted are free during beta/forever. Cloud is free during beta (limited seats). Self-hosted is free forever under the MIT license.

Where does my data flow when using AdLoop?

With AdLoop Cloud, your data flows through EU servers in Germany (GDPR-first, DPA included). With the self-hosted version, 100% of your data stays on your machine — nothing leaves it.