get_connector_analytics
Members, access and revenue per connector — which connector earns, and which one members actually use.
Return one row per connector the creator's projects run or ever granted access on: the live installations, the members holding a linked account (and how many linked one in the window), the live and pending grants, the grants issued and revoked in the window, the gross revenue in USD with its transaction count and its share of the total. The same figures the dashboards' By Connector panel and GET /v1/analytics/connectors show. A purchase that grants access on two connectors counts toward both; attribution says so in the creator's language.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_idstringoptionalOptional project UUID to scope the figures. Leave blank for all projects in the current team.
periodstringoptionalPeriod preset — 7d, 14d, 30d, 60d, 90d, mtd, qtd, ytd, 1y, all. Defaults to 30d.
fromstringoptionalExplicit start date (ISO YYYY-MM-DD). Overrides period when paired with "to".
tostringoptionalExplicit end date (ISO YYYY-MM-DD). Overrides period when paired with "from".
What it returns
{ "data": { "range": { "from": "2026-08-13", "to": "2026-09-12" }, "total_gross_usd": 1682.0, "attribution": "A purchase that grants access on two connectors counts toward both.", "connectors": [ { "key": "telegram", "name": "Telegram", "installations": 2, "members": 241, "members_linked_in_window": 18, "live_grants": 236, "pending_grants": 3, "granted_in_window": 21, "revoked_in_window": 4, "gross_usd": 1682.0, "transactions": 58, "share_percent": 100 } ] }, "meta": { "period": "30d", "project_id": null }}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks dashboard:read.
How is this guide?
Last updated on
Analytics & Reports Tools
Every figure the creator dashboard renders is readable here, from revenue and churn to the transaction list, computed by the same service layer, so an agent and the dashboard never disagree.
get_dashboard_metrics
Return headline dashboard metrics — MRR, active subscribers, churn, and plan-level breakdown — with a period-over-period comparison.