ga4_run_realtime_report
Run GA4 Realtime Report
Ga4Description
Run a GA4 realtime report (last 30 minutes of events). Primary use: verifying tags and key events fire after a tracking change, without waiting for standard processing lag. Args: property_id (string, required): GA4 property ID (numeric) or full resource name. dimensions (string[], optional): Up to 9 realtime dimension API names (e.g. eventName, unifiedScreenName, country, deviceCategory). metrics (string[], required): 1-10 realtime metric API names (e.g. activeUsers, eventCount, keyEvents). limit (number, optional): Max rows, default 50. Returns: row_count and rows flattened as { dimension: value, metric: value } objects.
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ga4_run_realtime_report",
"arguments": {
"property_id": "123456789",
"dimensions": [
"eventName"
],
"metrics": [
"eventCount"
],
"reason": "Confirm tags fire after a tracking change"
}
}
}
hopkin ga4 realtime-report
| Flag | Type | Required | Description |
|---|---|---|---|
--property-id | string | Required | GA4 property ID (numeric) or full resource name. |
--dimensions | array | Optional | Realtime dimension API names, e.g. eventName, unifiedScreenName, country, deviceCategory. |
--metrics | array | Required | Realtime metric API names, e.g. activeUsers, eventCount, keyEvents. |
--limit | integer | Optional | Max rows (default 50). |
{
"mcpServers": {
"ga4": {
"url": "https://ga4.mcp.hopkin.ai",
"transport": "sse"
}
}
}
- Verify events firing
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
property_id |
string |
Required | GA4 property ID (numeric) or full resource name.minLength: 1 |
metrics |
array |
Required | Realtime metric API names, e.g. activeUsers, eventCount, keyEvents. |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (2)
| Name | Type | Required | Description |
|---|---|---|---|
dimensions |
array |
Optional | Realtime dimension API names, e.g. eventName, unifiedScreenName, country, deviceCategory. |
limit |
integer |
Optional | Max rows (default 50).min: 1, max: 10000 |
Examples
Verify events firing
{
"property_id": "123456789",
"dimensions": [
"eventName"
],
"metrics": [
"eventCount"
],
"reason": "Confirm tags fire after a tracking change"
}
hopkin ga4 realtime-report --property-id 123456789 --dimensions eventName --metrics eventCount