omni_car_depreciation
Calculate multi-year vehicle depreciation curves, future resale value, cumulative dollar loss, monthly depreciation cost, and trade-in horizons from purchase price, ownership years, and depreciation profile.
Instructions
Car Depreciation & Future Value Curve Calculator. Calculate multi-year vehicle depreciation curves, month-by-month residual value, dollar loss per mile driven, and optimal trade-in horizons. Discipline: FINANCE. Governing mathematical model / formula: Value(t) = Purchase Price × (1 - Depreciation Rate)^t.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of residual_future_value (Projected Future Resale Value), total_dollar_depreciation (Total Cumulative Dollar Loss), first_year_drop (Year 1 Immediate Depreciation), monthly_depreciation_cost (Average Monthly Depreciation Drag) using initial_purchase_price (Vehicle Purchase Price), vehicle_age_years (Ownership Horizon (Years) in years), depreciation_profile (Depreciation Category (0.85 Low/Toyota, 1.0 Normal, 1.25 Luxury/German)). 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 'Car Depreciation & Future Value Curve 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): "car-depreciation"
category (string): "finance"
name (string): "Car Depreciation & Future Value Curve Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.residual_future_value (Projected Future Resale Value): Formatted display string (e.g. '$18,000.00')
metrics.total_dollar_depreciation (Total Cumulative Dollar Loss): Formatted display string (e.g. '-$27,000.00')
metrics.first_year_drop (Year 1 Immediate Depreciation): Formatted display string (e.g. '$9,000.00 (20%)')
metrics.monthly_depreciation_cost (Average Monthly Depreciation Drag): Formatted display string (e.g. '$450.00 / mo')
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_car_depreciation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vehicle_age_years | No | Ownership Horizon (Years) (years). Years you plan to keep vehicle. Default: 5. Min: 1. Max: 15. | |
| depreciation_profile | No | Depreciation Category (0.85 Low/Toyota, 1.0 Normal, 1.25 Luxury/German). Trucks/Hondas hold value; luxury sedans drop fast. Default: 1. Min: 0.7. Max: 1.6. | |
| initial_purchase_price | No | Vehicle Purchase Price. Original out-the-door price paid. Default: 45000. Min: 5000. Max: 250000. |