omni_fleet_tco_per_mile
Calculates total cost of ownership and operating cost per mile for commercial Class 8 tractors using fuel, driver, lease, maintenance, tire, and insurance inputs.
Instructions
Fleet Total Cost of Ownership (TCO) & Operating Cost Per Mile. Calculate total cost of ownership (TCO) and marginal cost per mile (MCPM) for commercial Class 8 tractors (fuel, driver, lease, maintenance, tires, insurance). Discipline: LOGISTICS. Governing mathematical model / formula: Cost Per Mile (CPM) = (Fixed Annual Overhead / Annual Miles) + Variable Operating Cost Per Mile.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_cost_per_mile (Total Operating Cost Per Mile), annual_total_operating_cost (Total Annual Cost Per Tractor), fuel_cost_per_mile (Fuel Cost Per Mile (6.5 MPG)), fixed_overhead_per_mile (Fixed Equipment Overhead) using annual_truck_miles (Annual Miles Driven Per Truck in miles/yr), driver_pay_cpm (Driver Wage & Benefits ($/Mile)), diesel_price_gal (Average Diesel Fuel Price ($/gal)), truck_lease_mo (Monthly Truck & Trailer Lease Payment ($)), annual_insurance_cost (Annual Commercial Truck Insurance ($)). 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 'Fleet Total Cost of Ownership (TCO) & Operating Cost Per Mile' 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): "fleet-tco-per-mile"
category (string): "logistics"
name (string): "Fleet Total Cost of Ownership (TCO) & Operating Cost Per Mile"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_cost_per_mile (Total Operating Cost Per Mile): Formatted display string (e.g. '$2.05 / mile')
metrics.annual_total_operating_cost (Total Annual Cost Per Tractor): Formatted display string (e.g. '$225,500.00 / yr')
metrics.fuel_cost_per_mile (Fuel Cost Per Mile (6.5 MPG)): Formatted display string (e.g. '$0.61 / mile')
metrics.fixed_overhead_per_mile (Fixed Equipment Overhead): Formatted display string (e.g. '$0.39 / mile')
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_fleet_tco_per_mile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| driver_pay_cpm | No | Driver Wage & Benefits ($/Mile). Base wage per mile plus payroll tax and health benefits. Default: 0.72. Min: 0.4. Max: 1.2. | |
| truck_lease_mo | No | Monthly Truck & Trailer Lease Payment ($). Financing or lease cost per equipment unit. Default: 2400. Min: 800. Max: 4500. | |
| diesel_price_gal | No | Average Diesel Fuel Price ($/gal). Average diesel fuel pump price. Default: 3.95. Min: 2. Max: 6.5. | |
| annual_truck_miles | No | Annual Miles Driven Per Truck (miles/yr). Typical OTR truck covers 100k-125k miles/year. Default: 110000. Min: 25000. Max: 200000. | |
| annual_insurance_cost | No | Annual Commercial Truck Insurance ($). Primary auto liability, cargo, and physical damage. Default: 14500. Min: 5000. Max: 35000. |