omni_mortgage_solver
Calculates monthly principal and interest payments, total interest, total loan cost, and accelerated payoff savings for fixed-rate residential mortgages.
Instructions
Fixed-Rate Mortgage Payment & Amortization Calculator: Calculates exact monthly principal and interest (P&I) installments, total cumulative interest, total cost of loan, and accelerated payoff interest savings with extra monthly principal payments for fixed-rate residential mortgages.
GOVERNING MATHEMATICAL EQUATIONS:
Monthly Payment: M = P · [r(1+r)ⁿ] / [(1+r)ⁿ - 1], where r = APR / 1200 and n = years × 12.
Total Cumulative Interest = (M · n) - P
Total Cost of Loan = M · n
Accelerated Payoff: Extra monthly principal directly reduces remaining balance, reducing subsequent monthly interest accrual.
USAGE GUIDELINES:
WHEN TO USE: Invoke for calculating monthly mortgage payments, interest burden, and early payoff schedules for residential fixed-rate home loans.
WHEN NOT TO USE: Do not use for commercial construction loans, interest-only balloon mortgages, or reverse mortgages.
SIBLING DIFFERENTIATION: Dedicated strictly to residential fixed-rate amortizing first mortgages. For short-term real estate investment bridge loans or flip financing, query slug 'hard-money-loan' or 'hard-money-points' via 'omni_universal_query'. For revolving home equity lines of credit, query slug 'heloc' via 'omni_universal_query'. For comparing multiple loan options (e.g. 15-year vs 30-year), use 'omni_batch_calculate'.
PARAMETER RELATIONSHIPS & CONSTRAINTS:
'loan_amount': Total borrowed principal balance in USD ($) (min 1,000, max 20,000,000, default 400,000).
'interest_rate_pct': Fixed annual interest rate percentage (APR) (min 0.1, max 25.0, default 6.75). Converted internally to monthly rate r = rate / 1200.
'loan_term_years': Loan term duration in years (min 1, max 50, default 30). Total payments n = years × 12.
'extra_monthly_payment': Optional additional principal paid each month in USD ($) (min 0, default 0). Directly accelerates amortization schedule.
BEHAVIOR, SAFETY & DETERMINISM:
Pure deterministic loan amortization calculation with IEEE 754 precision.
Read-only, idempotent, and stateless. Zero side effects or persistent mutations.
RETURN VALUE SCHEMA & QUANTITIES:
source (string): Canonical documentation URL (https://omnioperand.com/finance/mortgage/)
inputs (object): Echoed input parameter values
metrics (object): Calculated financial metrics:
monthly_payment (number): Base monthly principal and interest installment ($/mo)
total_monthly_payment (number): Total monthly payment including extra principal ($/mo)
total_interest_paid (number): Total cumulative interest paid over the life of the loan ($)
total_cost_of_loan (number): Total cumulative principal plus interest ($)
payoff_months (number): Total number of months required to reach zero balance
payoff_years (number): Equivalent payoff timeline in years
interest_saved_with_extra (number): Total interest saved due to extra principal payments ($)
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_mortgage_solver"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loan_amount | No | Total borrowed mortgage principal amount in USD ($). | |
| loan_term_years | No | Mortgage amortization duration in years (typically 15, 20, or 30 years). | |
| interest_rate_pct | No | Annual percentage rate (APR) as a whole number (e.g. 6.75 for 6.75%). | |
| extra_monthly_payment | No | Optional extra principal payment added to each monthly installment in USD ($). |