ga4 run realtime report
ga4_run_realtime_reportRun a read-only GA4 Data API realtime report to fetch current active users, event counts, and supported dimensions/metrics for a property.
Instructions
Run a read-only GA4 Data API realtime report. Realtime supports only a limited subset of dimensions and metrics.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"propertyId": "<propertyId>"
},
"name": "ga4_run_realtime_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| metrics | No | Realtime metric API names, e.g. activeUsers, eventCount | |
| orderBys | No | Native GA4 OrderBy JSON. | |
| dimensions | No | Realtime dimension API names, e.g. eventName, city, deviceCategory | |
| propertyId | Yes | GA4 property ID (numeric, e.g., 123456789) | |
| metricFilter | No | Native realtime-compatible GA4 FilterExpression JSON. | |
| minuteRanges | No | Optional named realtime minute ranges; zero is the current minute. | |
| keepEmptyRows | No | Keep provider rows whose selected metrics are all zero, where supported. | |
| dimensionFilter | No | Native realtime-compatible GA4 FilterExpression JSON. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |