Calculate an auto loan
calculate_auto_loanMonthly payment, amount financed, total interest and total cost for one US car loan. Amount financed = price − down − trade-in + owed on trade-in; sales tax and fees are paid upfront unless tax_and_fees_financed is true, then they are added to the loan. total_cost = cash due at purchase + all payments (price + tax + fees + interest − trade-in + owed). Returns the inputs echoed back and a carloanmath.com share_url. When optional inputs are omitted, the result includes assumed_defaults (the values actually used) and a short text line so you can call again with those parameters. assumed_defaults is omitted when every optional input was provided.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"price": "<price>",
"apr": "<apr>",
"term_months": "<term_months>"
},
"name": "calculate_auto_loan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apr | Yes | Yearly interest rate in percent, compounded monthly (the same number as the site’s rate field), e.g. 6.5 for 6.5%. A lender’s APR can be a little higher because it folds in some fees. Use 0 for 0% financing. | |
| down | No | Cash down payment in USD. Default 0. | |
| fees | No | Title, registration, documentation and dealer fees in USD. Default 0. | |
| price | Yes | Vehicle price in USD (before tax, fees, down payment and trade-in). | |
| country | No | Country of the purchase, ISO 3166-1 alpha-2. Default "US". Only US is available for now. | US |
| trade_in | No | Trade-in value in USD credited against the price. Default 0. | |
| term_months | Yes | Loan term in whole months, 1–120 (common: 36, 48, 60, 72, 84). | |
| sales_tax_rate | No | Sales tax in percent of the vehicle price, e.g. 7 for 7%. No state rules or trade-in tax credit are applied. Default 0. | |
| owed_on_trade_in | No | Loan balance still owed on the trade-in, rolled into the new loan (negative equity). Default 0. | |
| tax_and_fees_financed | No | false (default, the site's "Pay upfront"): sales tax and fees are paid in cash at purchase, not financed. true: they are added to the loan. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | Yes | ||
| country | Yes | ||
| sales_tax | Yes | ||
| share_url | Yes | ||
| disclaimer | Yes | ||
| total_cost | Yes | ||
| total_interest | Yes | ||
| amount_financed | Yes | ||
| monthly_payment | Yes | ||
| assumed_defaults | No | Optional inputs the caller omitted, with the values actually used. The field is omitted when nothing was assumed. | |
| total_of_payments | Yes | ||
| cash_due_at_purchase | Yes |