omni_reverse_mortgage
Calculate HECM reverse mortgage borrowing power, principal limits, and lifetime monthly tenure payouts for homeowners 62+ using home value, age, and existing mortgage balance.
Instructions
Reverse Mortgage (HECM) Calculator. Estimate Home Equity Conversion Mortgage (HECM) borrowing power, principal limits, and tenure monthly payout streams for homeowners 62+. Discipline: FINANCE. Governing mathematical model / formula: Principal Limit = Home Value × Principal Limit Factor (Age, Rate).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of net_principal_limit (Net Available Cash Proceeds), gross_principal_limit (Gross Principal Limit), monthly_tenure (Lifetime Monthly Tenure Payout), fha_hecm_limit (FHA Maximum Claim Limit) using home_value (Appraised Home Value), youngest_age (Age of Youngest Borrower in yrs), existing_mortgage (Existing Mortgage Balance). 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 'Reverse Mortgage (HECM) 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): "reverse-mortgage"
category (string): "finance"
name (string): "Reverse Mortgage (HECM) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.net_principal_limit (Net Available Cash Proceeds): Formatted display string (e.g. '$178,500.00')
metrics.gross_principal_limit (Gross Principal Limit): Formatted display string (e.g. '$263,500.00')
metrics.monthly_tenure (Lifetime Monthly Tenure Payout): Formatted display string (e.g. '$1,120.00')
metrics.fha_hecm_limit (FHA Maximum Claim Limit): Formatted display string (e.g. '$1,149,825.00')
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_reverse_mortgage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| home_value | No | Appraised Home Value. Current fair market home value. Default: 550000. Min: 100000. Max: 1500000. | |
| youngest_age | No | Age of Youngest Borrower (yrs). Must be at least 62 years old. Default: 68. Min: 62. Max: 95. | |
| existing_mortgage | No | Existing Mortgage Balance. Must be paid off by reverse mortgage proceeds. Default: 85000. Min: 0. Max: 500000. |