adloop

adloop is a Python MCP server that lets an AI assistant read and (safely) write to Google Ads and GA4. It provides numerous MCP tools for diagnostics, GA4/Ads reporting, cross-referencing Ads vs GA4 (including attribution and landing-page analysis), tracking validation, and a draft→preview→confirm workflow for creating/updating Ads assets with guardrails (budget caps, pausing new entities, and double-confirmation for destructive actions).

Evaluated Mar 30, 2026 (0d ago)
Repo ↗ Automation mcp google-ads ga4 python ai-agent marketing-automation oauth analytics
⚙ Agent Friendliness
66
/ 100
Can an agent use this?
🔒 Security
67
/ 100
Is it safe for agents?
⚡ Reliability
42
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
85
Documentation
75
Error Messages
--
Auth Simplicity
55
Rate Limits
30

🔒 Security

TLS Enforcement
80
Auth Strength
80
Scope Granularity
50
Dep. Hygiene
55
Secret Handling
65

The project emphasizes operational safety: two-step writes (preview then confirm), dry-run default, audit logging, budget caps, new campaigns/ads start paused, and destructive actions require extra confirmation. OAuth/service-account support is provided, but the provided content does not enumerate OAuth scopes or demonstrate token storage hardening beyond writing files under ~/.adloop. No explicit mention of TLS enforcement details, dependency vulnerability status, or secret redaction in logs.

⚡ Reliability

Uptime/SLA
0
Version Stability
55
Breaking Changes
50
Error Recovery
65
AF Security Reliability

Best When

Teams want an AI-driven workflow inside Cursor/Claude Code to compare Ads vs GA4 and to propose Ads changes with explicit, confirm-and-apply guardrails.

Avoid When

You cannot or will not provide OAuth credentials and developer token access, or you require highly formalized change management beyond a dry_run/confirm workflow.

Use Cases

  • Diagnose why conversions dropped by correlating Google Ads clicks/sessions with GA4 conversions
  • Find tracking event mismatches between code and GA4
  • Analyze landing pages receiving paid traffic but not converting
  • Validate near-real-time tracking after deploys
  • Draft and preview responsive search ads, keywords, callouts, and other assets in a safe workflow
  • Generate negative keyword suggestions from search term reports
  • Estimate budgets via Google Ads Keyword Planner
  • Run health checks to test OAuth/GA4/Ads connectivity and report actionable auth issues

Not For

  • Use cases that require a public, unauthenticated web API for ad management
  • Fully automated changes with no human confirmation
  • Organizations that require strict data residency or compliance guarantees not described in the documentation
  • Scenarios where accidental ad spend must be impossible even with misconfiguration (requires additional external controls beyond what’s described)

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: OAuth (desktop app flow) using Google OAuth client credentials Service account key JSON (supported per README)
OAuth: Yes Scopes: No

Auth configuration is performed via an init wizard/manual steps; tokens are saved under ~/.adloop/token.json and refreshed automatically. Specific OAuth scopes are not listed in the provided content, but the toolset implies Ads/GA4 access.

Pricing

Free tier: No
Requires CC: No

Pricing for the package itself isn’t specified in the provided content; it appears distributed via PyPI under MIT. Google API usage costs depend on the user’s Google accounts.

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Write operations require explicit confirm_and_apply with dry_run=false for real changes; agents must avoid assuming writes happen automatically after draft/preview.
  • Budget caps and pausing defaults may cause confusion if the agent expects immediate live spending/serving.
  • Service-account vs OAuth credential types may differ operationally; ensure the correct credential path and account permissions in advance.

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for adloop.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

6533
Packages Evaluated
19870
Need Evaluation
586
Need Re-evaluation
Community Powered