Run Funnel Report
run_funnel_reportRun a funnel analysis to see how many users complete each step in a sequence, identifying drop-off points in Google Analytics 4.
Instructions
Run a funnel analysis report for a Google Analytics 4 property.
WARNING: EXPERIMENTAL: This uses the GA4 Data API v1alpha endpoint which is unstable and may break or change without notice.
A funnel shows how many users complete each step in a sequence — e.g. homepage -> product page -> add to cart -> purchase.
Each step in steps must be a dict with:
"name": human-readable step label (e.g. "Homepage")
"filterExpression": a GA4 funnel filter expression dict
STEP FORMAT EXAMPLES:
Page path step: { "name": "Homepage", "filterExpression": { "funnelFieldFilter": { "fieldName": "pagePath", "stringFilter": {"matchType": "EXACT", "value": "/"} } } }
Event step: { "name": "Purchase", "filterExpression": { "funnelEventFilter": { "eventName": "purchase" } } }
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_id": "<property_id>",
"start_date": "<start_date>",
"end_date": "<end_date>",
"steps": "<steps>"
},
"name": "run_funnel_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | Yes | List of funnel step dicts (minimum 2 steps) | |
| end_date | Yes | End date in YYYY-MM-DD format | |
| start_date | Yes | Start date in YYYY-MM-DD format | |
| property_id | Yes | Google Analytics 4 property ID (numeric, e.g., "123456789") | |
| breakdown_dimension | No | Optional dimension to break down funnel by (e.g. "deviceCategory") |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||