omni_social_security
Calculate optimal Social Security claiming age, monthly benefits at 62, 67, and 70, and breakeven life expectancy to maximize lifetime benefits from a given PIA.
Instructions
Social Security Benefit & Age Optimizer. Determine your optimal Social Security claiming age (62 vs 67 vs 70), breakeven life expectancy, and lifetime benefit maximization. Discipline: FINANCE. Governing mathematical model / formula: Monthly Benefit = PIA × (1 ± Actuarial Adjustment Factor).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of monthly_benefit (Monthly Benefit Received), age_62_benefit (Early Benefit at Age 62 (-30%)), age_70_benefit (Delayed Benefit at Age 70 (+24%)), breakeven_age (Breakeven Life Expectancy) using pia_amount (Full Retirement Primary Insurance (PIA)), claiming_age (Selected Claiming Age 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 'Social Security Benefit & Age Optimizer' 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): "social-security"
category (string): "finance"
name (string): "Social Security Benefit & Age Optimizer"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.monthly_benefit (Monthly Benefit Received): Formatted display string (e.g. '$2,400.00')
metrics.age_62_benefit (Early Benefit at Age 62 (-30%)): Formatted display string (e.g. '$1,680.00')
metrics.age_70_benefit (Delayed Benefit at Age 70 (+24%)): Formatted display string (e.g. '$2,976.00')
metrics.breakeven_age (Breakeven Life Expectancy): Formatted display string (e.g. '80.4 years')
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_social_security"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pia_amount | No | Full Retirement Primary Insurance (PIA). Estimated benefit at Full Retirement Age (67). Default: 2400. Min: 500. Max: 4500. | |
| claiming_age | No | Selected Claiming Age (yrs). Age you plan to start benefits. Default: 67. Min: 62. Max: 70. |