Skip to content
Get MCP AdsGet MCP Ads, home
Start free

Google Analytics 4 MCP API reference

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

34 rows

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 requestedLink to this section

ScopeGrantsAllows writes
https://www.googleapis.com/auth/analytics.readonlyRead GA4 reports, metadata and property configuration. Cannot modify anything.No

CataloguesLink to this section

Read tools (27)Link to this section

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.

ToolWhat it doesKindDiscovery
ga4_batch_run_pivot_reportsRun 1-5 independent read-only GA4 pivot reports for the same property in one official Data API batch request.ReadOn demand
ga4_batch_run_reportsRun 1-5 independent read-only GA4 Core reports for the same property in one official Data API batch request.ReadOn demand
ga4_check_compatibilityAsk the official GA4 Data API which dimensions and metrics are compatible with a proposed Core report selection.ReadOn demand
ga4_get_audience_diagnosticsRead-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback.ReadOn demand
ga4_get_audience_export_diagnosticsRead-only Audience Export diagnostics.ReadOn demand
ga4_get_bigquery_export_diagnosticsDetect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location.ReadOn demand
ga4_get_channel_groupsList custom channel groups defined for a GA4 property.ReadOn demand
ga4_get_custom_definitionsList custom dimensions and custom metrics exposed by GA4 Data API metadata.ReadOn demand
ga4_get_ecommerce_diagnosticsRead-only ecommerce coverage diagnostics for core ecommerce events, revenue metrics, and item-level reporting over a date range.ReadOn demand
ga4_get_event_parametersBest-effort event parameter inventory from GA4 metadata plus event reports.ReadOn demand
ga4_get_key_eventsInventory GA4 key events/conversions using metadata-aware Data API reports.ReadAnnounced
ga4_get_metadataGet the complete list of dimensions and metrics available for a specific GA4 property.ReadOn demand
ga4_get_property_configurationRead GA4 property details plus selected singleton Admin settings (attribution, retention, Google Signals, reporting identity, or user-provided-data settings).ReadOn demand
ga4_get_property_quotas_snapshotRead the current GA4 Data API property quota snapshot from the official v1alpha endpoint.ReadOn demand
ga4_get_server_side_tagging_diagnosticsBest-effort read-only server-side tagging diagnostics from data streams, Measurement Protocol secrets, event rules, and stream settings.ReadOn demand
ga4_health_checkRead-only GA4 health check.ReadAnnounced
ga4_list_accountsList raw GA4 Analytics Admin accounts accessible to the authenticated user (read-only, auto-paginated).ReadOn demand
ga4_list_admin_resourcesList 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.ReadOn demand
ga4_list_audience_exportsList existing GA4 Audience Export snapshots and Recurring Audience Lists without creating new exports.ReadOn demand
ga4_list_propertiesList all GA4 properties accessible with the current credentials.ReadAnnounced
ga4_query_audience_exportQuery rows from an existing GA4 Audience Export.ReadOn demand
ga4_run_advanced_funnel_reportRun the GA4 Data API v1alpha runFunnelReport endpoint with optional breakdown/next-action, falling back to read-only step counts if unavailable.ReadOn demand
ga4_run_funnel_recipeRun a read-only configurable funnel recipe using one GA4 report per eventName/pagePath step and return simple step counts.ReadOn demand
ga4_run_pivot_reportRun a read-only GA4 Data API pivot report with native filters, ordering, quota state, multiple date ranges, and up to 250,000 pivot cells.ReadOn demand
ga4_run_realtime_reportRun a read-only GA4 Data API realtime report.ReadAnnounced
ga4_run_reportRun a GA4 analytics report with intelligent query planning.ReadAnnounced
ga4_validate_queryValidate a metric/dimension combination BEFORE executing.ReadOn demand

MCP resourcesLink to this section

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

NameURI
ga4-metricsga4://metrics
ga4-dimensionsga4://dimensions
ga4-compatibilityga4://compatibility
ga4-manifestga4://manifest
ga4-recipesga4://recipes
ga4-p2-diagnosticsga4://p2-diagnostics
Esc

Type to search