ga4_run_report
Run read-only GA4 Data API reports over a date range to verify which configured GTM events actually fire; zero reported activity flags misconfigured tracking.
Instructions
Run a read-only GA4 Data API report for a property over a date range. Returns dimension/metric rows (e.g. event counts by eventName). Useful for reconciling configured GTM/GA4 events against events GA4 actually reports (zero reported activity for a configured event is a red flag). Read-only — never writes. Requires the analytics.readonly scope.
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": {
"property": "<property>",
"metrics": "<metrics>"
},
"name": "ga4_run_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return (default 250). | |
| offset | No | Row offset for paging (default 0). | |
| endDate | No | End date: YYYY-MM-DD, "NdaysAgo", "today", or "yesterday". | today |
| metrics | Yes | Metric names, e.g. ["eventCount","totalUsers"]. At least 1, max 10. | |
| property | Yes | GA4 property ID, e.g. "123456789" or "properties/123456789". | |
| startDate | No | Start date: YYYY-MM-DD, "NdaysAgo", "today", or "yesterday". | 7daysAgo |
| dimensions | No | Dimension names, e.g. ["eventName","date"]. Max 9. Omit for a metric-only report. | |
| orderByMetric | No | Metric name to order by (descending). Optional. |