Google Analytics 4 tools for Model Context Protocol clients
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"luminarylane-ga4-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# GA4 MCP Server [](https://modelcontextprotocol.io) [](https://python.org) [](LICENSE) A Model Context Protocol (MCP) server that connects Claude Desktop (and other MCP clients) to the Google Analytics 4 Data API — run reports, view top pages, analyze traffic sources, check realtime users, and compare periods. ## Features ### 7 Analytics Tools | Tool | Description | |------|-------------| | `ga4_list_properties` | List all GA4 properties accessible by the service account | | `ga4_get_report` | Run a custom report with any dimensions and metrics | | `ga4_get_top_pages` | Top pages by sessions with bounce rate and duration | | `ga4_get_traffic_sources` | Traffic breakdown by source/medium | | `ga4_get_conversions` | Conversion events and their counts | | `ga4_get_realtime` | Realtime active users and top pages | | `ga4_compare_periods` | Compare current vs previous period with percentage changes | ### Built-in Reliability - **Token-bucket rate limiter** — respects GA4's 10 concurrent request limit - **Auto-retry on 429/5xx** — exponential backoff (2s, 4s, 8s) up to 3 retries - **Lazy imports** — defers heavy Google client libraries for fast MCP handshake - **Actionable error messages** — guides users to fix permission, auth, and input errors ## Quick Start ### Prerequisites - Python 3.11+ - A Google Cloud service account with GA4 access - Claude Desktop (or any MCP-compatible client) ### Set Up Google Analytics Access 1. Create a [Google Cloud service account](https://console.cloud.google.com/iam-admin/serviceaccounts) 2. Enable the **Google Analytics Data API** and **Google Analytics Admin API** in your project 3. Download the service account JSON key file 4. In GA4: go to **Admin > Property Access Management** and add the service account email as a **Viewer** ### Installation Run the p…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.