omni_fire
Calculate your FIRE number, lean FIRE target, and years to financial independence from expenses, savings, net worth, and withdrawal rate.
Instructions
FIRE Calculator (Financial Independence, Retire Early). Calculate your exact FIRE Number, Lean/Fat FIRE targets, and time to complete financial freedom using Trinity Study safe withdrawal rates. Discipline: FINANCE. Governing mathematical model / formula: FIRE Number = Annual Living Expenses / Safe Withdrawal Rate (e.g. Expenses × 25).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of fire_number (Target FIRE Nest Egg), years_to_fire (Timeline to Financial Freedom), lean_fire (Lean FIRE (75% Expenses)) using annual_expenses (Annual Living Expenses), current_net_worth (Current Invested Net Worth), annual_savings (Annual Savings Contribution), swr_pct (Safe Withdrawal Rate (%) in %), real_return (Inflation-Adjusted Real Return (%) in %). 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 'FIRE Calculator (Financial Independence, Retire Early)' 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): "fire"
category (string): "finance"
name (string): "FIRE Calculator (Financial Independence, Retire Early)"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.fire_number (Target FIRE Nest Egg): Formatted display string (e.g. '$1,500,000.00')
metrics.years_to_fire (Timeline to Financial Freedom): Formatted display string (e.g. '14.2 years')
metrics.lean_fire (Lean FIRE (75% Expenses)): Formatted display string (e.g. '$1,125,000.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_fire"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| swr_pct | No | Safe Withdrawal Rate (%) (%). 4% standard (Trinity study); 3.25%-3.5% for early retirees. Default: 4. Min: 3. Max: 5. | |
| real_return | No | Inflation-Adjusted Real Return (%) (%). Real return after subtracting inflation. Default: 6.5. Min: 3. Max: 10. | |
| annual_savings | No | Annual Savings Contribution. Total saved and invested per year. Default: 35000. Min: 0. Max: 300000. | |
| annual_expenses | No | Annual Living Expenses. Target retirement spending per year. Default: 60000. Min: 10000. Max: 500000. | |
| current_net_worth | No | Current Invested Net Worth. Current liquid investable assets. Default: 180000. Min: 0. Max: 5000000. |