omni_personal_loan
Calculate fixed monthly installments, total interest, and total repayment for personal loans and debt consolidation using loan amount, interest rate, and term.
Instructions
Personal Loan & Debt Consolidation Calculator. Calculate fixed monthly installments, total interest, and consolidation savings for unsecured personal loans. Discipline: FINANCE. Governing mathematical model / formula: M = P · [r(1 + r)ⁿ] / [(1 + r)ⁿ - 1].
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of monthly_installment (Monthly Installment), total_interest (Total Cumulative Interest), total_repayment (Total Overall Repayment) using loan_amount (Loan Amount), interest_rate (Interest Rate (%) in %), term_months (Loan Term (Months) in mo). 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 'Personal Loan & Debt Consolidation 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): "personal-loan"
category (string): "finance"
name (string): "Personal Loan & Debt Consolidation Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.monthly_installment (Monthly Installment): Formatted display string (e.g. '$824.62')
metrics.total_interest (Total Cumulative Interest): Formatted display string (e.g. '$4,686.32')
metrics.total_repayment (Total Overall Repayment): Formatted display string (e.g. '$29,686.32')
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_personal_loan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loan_amount | No | Loan Amount. Requested personal borrowing amount. Default: 25000. Min: 1000. Max: 100000. | |
| term_months | No | Loan Term (Months) (mo). Repayment duration. Default: 36. Min: 12. Max: 84. | |
| interest_rate | No | Interest Rate (%) (%). Fixed APR based on credit tier. Default: 11.5. Min: 5. Max: 36. |