omni_mrr_arr
Calculate net new MRR, annualized ARR, gross new inflow, and churn leakage from new, expansion, contraction, and churned MRR inputs for exact finance arithmetic.
Instructions
MRR to ARR & Net New MRR Calculator. Calculate Annual Recurring Revenue (ARR) run rate, Net New MRR, expansion rate, and contraction churn components. Discipline: FINANCE. Governing mathematical model / formula: ARR = MRR × 12 | Net New MRR = New MRR + Expansion MRR - Contraction MRR - Churned MRR.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of net_new_mrr (Net New MRR Added), annual_arr_added (Net ARR Added (Annualized)), gross_new_mrr (Gross New Inflow), total_mrr_churn (Total Revenue Leakage) using new_mrr (New Customer MRR), expansion_mrr (Expansion / Upgrade MRR), contraction_mrr (Contraction / Downgrade MRR), churned_mrr (Churned / Canceled MRR). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
SIBLING ROUTING: Use this dedicated specialist tool for 'MRR to ARR & Net New MRR Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "mrr-arr"
category (string): "finance"
name (string): "MRR to ARR & Net New MRR Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.net_new_mrr (Net New MRR Added): Formatted display string (e.g. '+$9,000.00 / mo')
metrics.annual_arr_added (Net ARR Added (Annualized)): Formatted display string (e.g. '+$108,000.00 / yr')
metrics.gross_new_mrr (Gross New Inflow): Formatted display string (e.g. '$11,700.00 / mo')
metrics.total_mrr_churn (Total Revenue Leakage): Formatted display string (e.g. '-$2,700.00 / mo')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_mrr_arr"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| new_mrr | No | New Customer MRR. MRR from newly signed accounts. Default: 8500. Min: 0. Max: 1000000. | |
| churned_mrr | No | Churned / Canceled MRR. MRR completely terminated from cancellations. Default: 1900. Min: 0. Max: 200000. | |
| expansion_mrr | No | Expansion / Upgrade MRR. Existing customers upgrading tiers or adding seats. Default: 3200. Min: 0. Max: 500000. | |
| contraction_mrr | No | Contraction / Downgrade MRR. Existing customers downgrading plans. Default: 800. Min: 0. Max: 100000. |