Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_gross_revenue_retention

Calculates Gross Revenue Retention (GRR) from beginning MRR, churn, and contraction to isolate core revenue losses and benchmark retention against NRR and private equity standards.

Instructions

Gross Revenue Retention (GRR) vs NRR Calculator. Calculate Gross Revenue Retention (GRR), isolating core churn and contraction without obscuring losses behind expansion revenue. Discipline: FINANCE. Governing mathematical model / formula: GRR % = [(Beginning MRR - Churn - Contraction) / Beginning MRR] × 100.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of grr_percentage (Gross Revenue Retention (GRR)), gross_churn_pct (Total Gross Revenue Churn), retained_base_mrr (Retained Cohort Base Revenue), pe_benchmark_status (Private Equity Benchmark) using beg_mrr (Beginning of Period MRR), churn_lost (Canceled / Churned MRR), contract_lost (Contraction / Downgrade 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.

DISAMBIGUATION & BOUNDARIES:

  • Use this dedicated specialist tool for 'Gross Revenue Retention (GRR) vs NRR Calculator' rather than generic dispatchers like omni_universal_query.

  • For multi-calculation chained jobs, use 'omni_batch_calculate'.

  • To inspect schema fields, see 'omni_describe_solver'.

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): "gross-revenue-retention"

    • category (string): "finance"

    • name (string): "Gross Revenue Retention (GRR) vs NRR Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.grr_percentage (Gross Revenue Retention (GRR)): Formatted display string (e.g. '91.00%')

      • metrics.gross_churn_pct (Total Gross Revenue Churn): Formatted display string (e.g. '9.00%')

      • metrics.retained_base_mrr (Retained Cohort Base Revenue): Formatted display string (e.g. '$182,000.00 / mo')

      • metrics.pe_benchmark_status (Private Equity Benchmark): Formatted display string (e.g. 'Top Quartile (> 90% GRR)')

    • 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_gross_revenue_retention"
  }
}

Input Schema

NameRequiredDescriptionDefault
beg_mrrNoBeginning of Period MRR. Base recurring revenue at start of year/month. Default: 200000. Min: 1000. Max: 10000000.
churn_lostNoCanceled / Churned MRR. Revenue lost from total cancellations. Default: 12000. Min: 0. Max: 5000000.
contract_lostNoContraction / Downgrade MRR. Revenue lost from plan downgrades. Default: 6000. Min: 0. Max: 2000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools