get_plan_performance
Per-plan performance metrics for a project — active subscribers, revenue in window, and average ticket size.
Return one row per plan in a project with active-subscriber count, successful-payment count and revenue in the requested window, and an average ticket size. Accepts period presets or explicit from / to ISO dates.
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_id*stringUUID of the project to report on.
periodstringoptionalPeriod preset — 7d, 14d, 30d, 60d, 90d, mtd, qtd, ytd, 1y, all. Defaults to 30d. Ignored when both from and to are supplied.
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": [ { "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b", "plan_name": "Premium Monthly", "active_subscribers": 120, "payments_in_window": 98, "revenue_in_window": "2842.00", "avg_ticket": "29.00" } ], "meta": { "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "range": { "from": "2026-03-22", "to": "2026-04-22" } }}How is this guide?
Last updated on