omni_ev_vs_gas_savings
Calculate annual fuel, maintenance, and brake pad savings from switching an ICE car to an EV, returning total yearly and five-year cumulative cost differences.
Instructions
Electric Vehicle vs Gas Savings Calculator. Calculate annual fuel, maintenance, and brake pad cost savings switching from an internal combustion engine (ICE) car to an EV. Discipline: FINANCE. Governing mathematical model / formula: Annual Savings = (Gas Gallons × Price/Gal + ICE Maint) - (EV kWh × Price/kWh + EV Maint).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of annual_total_savings (Annual Total Operating Savings), five_year_savings (5-Year Cumulative Savings), annual_gas_fuel_cost (Annual Gasoline Expenditure), annual_ev_fuel_cost (Annual EV Electricity Expenditure) using annual_miles (Annual Driving Mileage in miles/yr), gas_car_mpg (Current Gas Car Fuel Economy (MPG) in MPG), gas_price_gallon (Local Gasoline Price ($/Gallon)), ev_efficiency_mi_kwh (EV Efficiency (Miles per kWh) in mi/kWh), electric_rate (Electricity Rate ($/kWh)). 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 'Electric Vehicle vs Gas Savings 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): "ev-vs-gas-savings"
category (string): "finance"
name (string): "Electric Vehicle vs Gas Savings Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.annual_total_savings (Annual Total Operating Savings): Formatted display string (e.g. '$1,725.00 / yr')
metrics.five_year_savings (5-Year Cumulative Savings): Formatted display string (e.g. '$8,625.00')
metrics.annual_gas_fuel_cost (Annual Gasoline Expenditure): Formatted display string (e.g. '$1,825.00 / yr')
metrics.annual_ev_fuel_cost (Annual EV Electricity Expenditure): Formatted display string (e.g. '$600.00 / yr')
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_ev_vs_gas_savings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gas_car_mpg | No | Current Gas Car Fuel Economy (MPG) (MPG). Combined city/highway miles per gallon. Default: 27. Min: 10. Max: 65. | |
| annual_miles | No | Annual Driving Mileage (miles/yr). US driver average: ~13,500 miles/yr. Default: 13500. Min: 2000. Max: 100000. | |
| electric_rate | No | Electricity Rate ($/kWh). Overnight home charging utility rate. Default: 0.16. Min: 0.05. Max: 0.6. | |
| gas_price_gallon | No | Local Gasoline Price ($/Gallon). Price per gallon of regular unleaded. Default: 3.65. Min: 2. Max: 7.5. | |
| ev_efficiency_mi_kwh | No | EV Efficiency (Miles per kWh) (mi/kWh). Standard EV: 3.2 to 4.0 miles/kWh. Default: 3.6. Min: 1.5. Max: 5. |