ChurnLens

{'type': 'object', 'required': ['customer_mrrs'], 'properties': {'top_n': {'type': 'number', 'description': 'How many top customers to aggregate for the top-N share. Default 5.'}, 'customer_mrrs': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Per-customer MRR values. Order does not matter.'}, 'whale_threshold_pct': {'type': 'number', 'description': 'Revenue share above which a customer counts as a whale. Default 25.'}}}

{'type': 'object', 'required': ['starting_mrr'], 'properties': {'churned_mrr': {'type': 'number', 'description': 'MRR lost to full cancellations.'}, 'starting_mrr': {'type': 'number', 'description': 'MRR at the start of the period, in any single currency unit.'}, 'expansion_mrr': {'type': 'number', 'description': 'MRR gained from upgrades and expansion within the existing base. Excludes new customers.'}, 'contraction_mrr': {'type': 'number', 'description': 'MRR lost to downgrades (customer retained).'}}}

{'type': 'object', 'required': ['arpa', 'monthly_churn_rate_pct'], 'properties': {'cac': {'type': 'number', 'description': 'Customer acquisition cost. Optional — supply it to get the ratio and payback.'}, 'arpa': {'type': 'number', 'description': 'Average revenue per account, per month.'}, 'gross_margin_pct': {'type': 'number', 'description': 'Gross margin percentage. Defaults to 100, which gives lifetime revenue.'}, 'monthly_churn_rate_pct': {'type': 'number', 'description': 'Monthly churn, as a percentage.'}}}

{'type': 'object', 'required': ['accounts'], 'properties': {'accounts': {'type': 'array', 'items': {'type': 'object', 'required': ['mrr', 'days_since_last_activity'], 'properties': {'mrr': {'type': 'number'}, 'customer': {'type': 'string'}, 'days_since_last_activity': {'type': 'number'}}}, 'description': 'One entry per paying account.'}, 'threshold_days': {'type': 'number', 'description': 'Days of inactivity before an account counts as dormant. Default 90.'}}}

{'type': 'object', 'properties': {'metric': {'enum': ['nrr', 'concentration', 'health'], 'type': 'string', 'description': "Which band set to return: 'nrr', 'concentration', 'health', or omit for all."}}}

{'type': 'object', 'required': ['monthly_churn_rate_pct', 'nrr_pct', 'top_customer_share_pct', 'ltv_to_cac_ratio', 'annual_plan_share_pct'], 'properties': {'nrr_pct': {'type': 'number', 'description': 'Net revenue retention, as a percentage.'}, 'ltv_to_cac_ratio': {'type': 'number', 'description': 'Lifetime value divided by customer acquisition cost.'}, 'annual_plan_share_pct': {'type': 'number', 'description': 'Share of revenue on annual contracts, as a percentage.'}, 'monthly_churn_rate_pct': {'type': 'number', 'description': 'Monthly revenue churn, as a percentage (5 means 5%).'}, 'top_customer_share_pct': {'type': 'number', 'description': "Largest single customer's share of revenue, as a percentage."}}}