ga_run_report
ActiveTool of Google_analytics
declared in 0.1.0
Query GA4 analytics data by dimensions (e.g., "city", "pagePath") and metrics (e.g., "activeUsers", "sessions") for a date range. Returns aggregated data rows with dimension and metric values.
Parameters schema
{
"type": "object",
"examples": [
{
"metrics": [
"activeUsers",
"sessions"
],
"end_date": "today",
"start_date": "30daysAgo",
"property_id": "123456789"
},
{
"limit": 500,
"metrics": [
"screenPageViews",
"bounceRate"
],
"end_date": "2024-01-31",
"order_bys": [
{
"desc": true,
"metric": {
"metricName": "screenPageViews"
}
}
],
"dimensions": [
"city",
"pagePath"
],
"start_date": "2024-01-01",
"property_id": "123456789"
}
],
"required": [
"property_id",
"metrics",
"start_date",
"end_date"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of rows to return (default 100, max 10000)"
},
"metrics": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of metric names (e.g., [\"activeUsers\", \"sessions\", \"screenPageViews\"])"
},
"end_date": {
"type": "string",
"description": "End date (YYYY-MM-DD or relative: \"today\", \"yesterday\")"
},
"order_bys": {
"type": "array",
"items": {
"type": "object"
},
"description": "Optional ordering. Each item: { dimension: { dimensionName, orderType? } } or { metric: { metricName }, desc? }"
},
"dimensions": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of dimension names (e.g., [\"city\", \"pagePath\", \"date\"])"
},
"start_date": {
"type": "string",
"description": "Start date (YYYY-MM-DD or relative: \"today\", \"yesterday\", \"7daysAgo\", \"30daysAgo\")"
},
"property_id": {
"type": "string",
"description": "GA4 property ID (numeric, e.g., \"123456789\")"
},
"dimension_filter": {
"type": "object",
"description": "Optional dimension filter object (GA4 FilterExpression format)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Google_analytics
https://github.com/pipeworx-io/mcp-google_analytics
1/7 registries