MMetadata /docs
Docs/Tools/account_funnel_reports

account_funnel_reports

Account-level funnel performance across stages.

Read analytics

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Account-level funnel performance across stages.

USE FOR: Account progression through funnel stages, account engagement/conversion analysis, social media account reach, account-level pipeline/revenue tracking.

REQUIRED: startDate, endDate, reportTab

REPORT TABS:
- REACHED: Accounts reached by campaigns
- ENGAGED: Accounts that engaged with content
- CONVERTED: Accounts that converted (leads)
- MQL: Marketing qualified accounts
- OPPS: Accounts with opportunities
- WON: Accounts with closed-won deals

Include company name AND domain when available in results.

Arguments

ArgumentTypeNotes
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, WON
one 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 supported
one of: SOCIAL

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"account_funnel_reports","arguments":{"startDate":"<startDate>","endDate":"<endDate>","reportTab":"REACHED"}}}'

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.

arguments used
{
 "startDate": "2026-08-06T17:01:08.920Z",
 "endDate": "2026-09-05T17:01:08.920Z",
 "reportTab": "REACHED"
}

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.

recorded response
"[value redacted]"

Other analytics tools:

All 160 tools · machine-readable index