omni_fsa_use_it_or_lose_it
Calculate net FSA tax savings and optimal annual election to prevent forfeiture of unused healthcare funds under IRS use-it-or-lose-it rules.
Instructions
Healthcare FSA Contribution & Forfeiture Calculator. Calculate Healthcare Flexible Spending Account (FSA) tax savings, optimal annual election, and avoid forfeiture under the IRS 'use-it-or-lose-it' rule. Discipline: FINANCE. Governing mathematical model / formula: Net FSA Benefit = (FSA Contribution × Tax Rate %) - Forfeited Unused Balance.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of net_fsa_tax_savings (Net Cash Tax Savings Realized), forfeited_cash_loss (Estimated Forfeited Unused Cash), gross_tax_deduction_benefit (Gross Tax Deduction Value), fsa_recommendation (FSA Strategy Guidance) using annual_fsa_election (Annual Healthcare FSA Election (Max $3,200)), projected_medical_spend (Projected Out-of-Pocket Medical Expenses), marginal_tax_bracket_fsa (Combined Tax Bracket (Income + FICA) in %), employer_rollover_cap (Employer Plan Rollover Limit ($640 Max)). 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 'Healthcare FSA Contribution & Forfeiture 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): "fsa-use-it-or-lose-it"
category (string): "finance"
name (string): "Healthcare FSA Contribution & Forfeiture Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.net_fsa_tax_savings (Net Cash Tax Savings Realized): Formatted display string (e.g. '$696.30 Cash Saved')
metrics.forfeited_cash_loss (Estimated Forfeited Unused Cash): Formatted display string (e.g. '$0.00 (Protected by Rollover)')
metrics.gross_tax_deduction_benefit (Gross Tax Deduction Value): Formatted display string (e.g. '$791.25')
metrics.fsa_recommendation (FSA Strategy Guidance): Formatted display string (e.g. 'Optimal Election (Full Expenses Covered)')
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_fsa_use_it_or_lose_it"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| annual_fsa_election | No | Annual Healthcare FSA Election (Max $3,200). 2024 IRS individual cap = $3,200. Default: 2500. Min: 250. Max: 3200. | |
| employer_rollover_cap | No | Employer Plan Rollover Limit ($640 Max). IRS allows up to $640 rollover into next plan year. Default: 640. Min: 0. Max: 640. | |
| projected_medical_spend | No | Projected Out-of-Pocket Medical Expenses. Copays, prescriptions, dental, vision, braces. Default: 2200. Min: 100. Max: 5000. | |
| marginal_tax_bracket_fsa | No | Combined Tax Bracket (Income + FICA) (%). 24% income tax + 7.65% FICA = 31.65%. Default: 31.65. Min: 15. Max: 50. |