omni_heloc
Calculates HELOC interest-only draw-period payments and fully amortizing repayment installments from balance, rate, and terms, preventing manual arithmetic mistakes.
Instructions
HELOC (Home Equity Line of Credit) Payment Calculator. Calculate interest-only draw period payments and fully amortizing repayment installments for a Home Equity Line of Credit. Discipline: FINANCE. Governing mathematical model / formula: Interest-Only Payment = (Balance · Annual Rate) / 12.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of draw_payment (Draw Period Monthly Payment), repay_payment (Repayment Monthly Payment), total_interest_draw (Total Draw Period Interest), total_cost (Total Cumulative Cost) using line_amount (Drawn HELOC Balance), heloc_rate (Variable Interest Rate (%) in %), draw_years (Draw Period (Years) in yrs), repay_years (Repayment Period (Years) 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 'HELOC (Home Equity Line of Credit) Payment 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): "heloc"
category (string): "finance"
name (string): "HELOC (Home Equity Line of Credit) Payment Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.draw_payment (Draw Period Monthly Payment): Formatted display string (e.g. '$531.25')
metrics.repay_payment (Repayment Monthly Payment): Formatted display string (e.g. '$650.84')
metrics.total_interest_draw (Total Draw Period Interest): Formatted display string (e.g. '$63,750.00')
metrics.total_cost (Total Cumulative Cost): Formatted display string (e.g. '$156,201.60')
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_heloc"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draw_years | No | Draw Period (Years) (yrs). Initial interest-only draw period. Default: 10. Min: 5. Max: 15. | |
| heloc_rate | No | Variable Interest Rate (%) (%). Current annual variable percentage rate (APR). Default: 8.5. Min: 2. Max: 18. | |
| line_amount | No | Drawn HELOC Balance. Amount drawn against home equity line. Default: 75000. Min: 5000. Max: 500000. | |
| repay_years | No | Repayment Period (Years) (yrs). Subsequent principal + interest repayment term. Default: 20. Min: 5. Max: 20. |