# Google Analytics 4

> Every Google Analytics 4 tool the MCP server exposes, with its parameters. 27 tools, 51 metrics and 62 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Reports, realtime, funnels, key events, ecommerce and server-side tagging diagnostics.

Connection

|  |  |
| --- | --- |
| Platform id | `ga4` |
| Tool prefix | `ga4_` |
| Account parameter | `propertyId` |
| Dedicated endpoint | https://mcp.getmcpads.com/ga4/mcp |
| Tools | 27, 0 of which write |
| Metrics | 51 |
| Dimensions | 62 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `https://www.googleapis.com/auth/analytics.readonly` | Read GA4 reports, metadata and property configuration. Cannot modify anything. | No |

> **Note** This source is read only. The gateway exposes no write tool for it.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/ga4/metrics): 51 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/ga4/dimensions): 62 dimensions, with their constraints.

## Read tools (27)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`ga4_batch_run_pivot_reports`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_batch_run_pivot_reports) | Run 1-5 independent read-only GA4 pivot reports for the same property in one official Data API batch request. | Read | On demand |
| [`ga4_batch_run_reports`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_batch_run_reports) | Run 1-5 independent read-only GA4 Core reports for the same property in one official Data API batch request. | Read | On demand |
| [`ga4_check_compatibility`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_check_compatibility) | Ask the official GA4 Data API which dimensions and metrics are compatible with a proposed Core report selection. | Read | On demand |
| [`ga4_get_audience_diagnostics`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_audience_diagnostics) | Read-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback. | Read | On demand |
| [`ga4_get_audience_export_diagnostics`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_audience_export_diagnostics) | Read-only Audience Export diagnostics. | Read | On demand |
| [`ga4_get_bigquery_export_diagnostics`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_bigquery_export_diagnostics) | Detect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location. | Read | On demand |
| [`ga4_get_channel_groups`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_channel_groups) | List custom channel groups defined for a GA4 property. | Read | On demand |
| [`ga4_get_custom_definitions`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_custom_definitions) | List custom dimensions and custom metrics exposed by GA4 Data API metadata. | Read | On demand |
| [`ga4_get_ecommerce_diagnostics`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_ecommerce_diagnostics) | Read-only ecommerce coverage diagnostics for core ecommerce events, revenue metrics, and item-level reporting over a date range. | Read | On demand |
| [`ga4_get_event_parameters`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_event_parameters) | Best-effort event parameter inventory from GA4 metadata plus event reports. | Read | On demand |
| [`ga4_get_key_events`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_key_events) | Inventory GA4 key events/conversions using metadata-aware Data API reports. | Read | Announced |
| [`ga4_get_metadata`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_metadata) | Get the complete list of dimensions and metrics available for a specific GA4 property. | Read | On demand |
| [`ga4_get_property_configuration`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_property_configuration) | Read GA4 property details plus selected singleton Admin settings (attribution, retention, Google Signals, reporting identity, or user-provided-data settings). | Read | On demand |
| [`ga4_get_property_quotas_snapshot`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_property_quotas_snapshot) | Read the current GA4 Data API property quota snapshot from the official v1alpha endpoint. | Read | On demand |
| [`ga4_get_server_side_tagging_diagnostics`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_server_side_tagging_diagnostics) | Best-effort read-only server-side tagging diagnostics from data streams, Measurement Protocol secrets, event rules, and stream settings. | Read | On demand |
| [`ga4_health_check`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_health_check) | Read-only GA4 health check. | Read | Announced |
| [`ga4_list_accounts`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_list_accounts) | List raw GA4 Analytics Admin accounts accessible to the authenticated user (read-only, auto-paginated). | Read | On demand |
| [`ga4_list_admin_resources`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_list_admin_resources) | List an allowlisted GA4 Admin collection in read-only mode: streams, custom definitions, key events, audiences, product links, annotations, channel groups, expanded datasets, subproperty/rollup configuration, and access bindings. | Read | On demand |
| [`ga4_list_audience_exports`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_list_audience_exports) | List existing GA4 Audience Export snapshots and Recurring Audience Lists without creating new exports. | Read | On demand |
| [`ga4_list_properties`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_list_properties) | List all GA4 properties accessible with the current credentials. | Read | Announced |
| [`ga4_query_audience_export`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_query_audience_export) | Query rows from an existing GA4 Audience Export. | Read | On demand |
| [`ga4_run_advanced_funnel_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_advanced_funnel_report) | Run the GA4 Data API v1alpha runFunnelReport endpoint with optional breakdown/next-action, falling back to read-only step counts if unavailable. | Read | On demand |
| [`ga4_run_funnel_recipe`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_funnel_recipe) | Run a read-only configurable funnel recipe using one GA4 report per eventName/pagePath step and return simple step counts. | Read | On demand |
| [`ga4_run_pivot_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_pivot_report) | Run a read-only GA4 Data API pivot report with native filters, ordering, quota state, multiple date ranges, and up to 250,000 pivot cells. | Read | On demand |
| [`ga4_run_realtime_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_realtime_report) | Run a read-only GA4 Data API realtime report. | Read | Announced |
| [`ga4_run_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_report) | Run a GA4 analytics report with intelligent query planning. | Read | Announced |
| [`ga4_validate_query`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_validate_query) | Validate a metric/dimension combination BEFORE executing. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| ga4-metrics | `ga4://metrics` |
| ga4-dimensions | `ga4://dimensions` |
| ga4-compatibility | `ga4://compatibility` |
| ga4-manifest | `ga4://manifest` |
| ga4-recipes | `ga4://recipes` |
| ga4-p2-diagnostics | `ga4://p2-diagnostics` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/ga4
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.