---
title: "account_funnel_reports. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/account_funnel_reports
description: "Account-level funnel performance across stages. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# account_funnel_reports

Account-level funnel performance across stages.

Read [analytics](https://metadata.io/developers/tools/#cat-analytics)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `startDate` | string | required | Start date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: '2025-01-01T00:00:00.000Z' |
| `endDate` | string | required | End date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: '2025-12-31T23:59:59.999Z' |
| `reportTab` | string | required | Funnel stage to analyze. Options: REACHED (default), ENGAGED, CONVERTED, MQL, OPPS, WONone of: `REACHED`, `ENGAGED`, `CONVERTED`, `MQL`, `OPPS`, `WON` |
| `page` | integer |   | Page number for pagination (0-based) |
| `size` | integer |   | Number of results per page. Default: 15, Max: 10000 — raise it to pull the full funnel set in one call. |
| `sort` | string |   | Sort criteria. Examples: 'impressions,desc' (default), 'engagement,desc', 'conversions,desc' |
| `type` | string |   | Report type. Currently only SOCIAL is supportedone of: `SOCIAL` |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a `list_` call immediately before.

Real, from the production server, in **3911 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other analytics tools:

- [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read
- [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read
- [budget_group_performance](https://metadata.io/developers/tools/budget_group_performance) Read
- [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read
- [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read
- [experiment_performance_stats](https://metadata.io/developers/tools/experiment_performance_stats) Read
- [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read
- [get_account_summary_insights](https://metadata.io/developers/tools/get_account_summary_insights) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)