Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_pension_vs_lump_sum

Calculate the hurdle rate required for a lump-sum rollover to beat a lifetime pension annuity, plus cumulative payouts and an actuarial recommendation from pension, lump sum, and life expectancy inputs.

Instructions

Pension Annuity vs Lump Sum Calculator. Evaluate defined benefit pension options. Determine the internal rate of return (IRR) required to beat a lifetime pension annuity with a lump sum rollover. Discipline: FINANCE. Governing mathematical model / formula: Required Hurdle Rate = Internal Rate of Return (IRR) Equating Lump Sum to Annuity.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of hurdle_rate (Required Hurdle Return Rate), total_pension_collected (Cumulative Pension Payout), recommendation (Actuarial Verdict) using monthly_pension (Monthly Lifetime Pension Annuity), lump_sum (Offered Lump Sum Buyout), life_expectancy_years (Expected Years in Retirement in yrs). 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 'Pension Annuity vs Lump Sum 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): "pension-vs-lump-sum"

    • category (string): "finance"

    • name (string): "Pension Annuity vs Lump Sum Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.hurdle_rate (Required Hurdle Return Rate): Formatted display string (e.g. '6.35%')

      • metrics.total_pension_collected (Cumulative Pension Payout): Formatted display string (e.g. '$840,000.00')

      • metrics.recommendation (Actuarial Verdict): Formatted display string (e.g. 'Annuity Favored (High Hurdle Rate)')

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

Input Schema

NameRequiredDescriptionDefault
lump_sumNoOffered Lump Sum Buyout. One-time cash buyout offered by employer. Default: 420000. Min: 20000. Max: 3000000.
monthly_pensionNoMonthly Lifetime Pension Annuity. Single life or joint-and-survivor monthly payout. Default: 2800. Min: 200. Max: 25000.
life_expectancy_yearsNoExpected Years in Retirement (yrs). Actuarial life horizon. Default: 25. Min: 10. Max: 40.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools