Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

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

NameRequiredDescriptionDefault
gas_car_mpgNoCurrent Gas Car Fuel Economy (MPG) (MPG). Combined city/highway miles per gallon. Default: 27. Min: 10. Max: 65.
annual_milesNoAnnual Driving Mileage (miles/yr). US driver average: ~13,500 miles/yr. Default: 13500. Min: 2000. Max: 100000.
electric_rateNoElectricity Rate ($/kWh). Overnight home charging utility rate. Default: 0.16. Min: 0.05. Max: 0.6.
gas_price_gallonNoLocal Gasoline Price ($/Gallon). Price per gallon of regular unleaded. Default: 3.65. Min: 2. Max: 7.5.
ev_efficiency_mi_kwhNoEV Efficiency (Miles per kWh) (mi/kWh). Standard EV: 3.2 to 4.0 miles/kWh. Default: 3.6. Min: 1.5. Max: 5.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools