Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_ev_charging_cost

Calculate EV charging costs: compare home versus public DC fast full-charge price, cost per mile, and monthly electricity bill from battery capacity and kWh rates.

Instructions

Electric Vehicle (EV) Charging Cost & Range Calculator. Calculate exact dollar cost to fully charge an electric car at home versus public DC fast chargers, cost per mile, and monthly charging expense. Discipline: PHYSICS. Governing mathematical model / formula: Full Charge Cost = Battery Capacity (kWh) × Electricity Rate ($/kWh) / Charging Efficiency.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of home_full_charge (Home Full 0-100% Charge Cost), public_full_charge (Public Fast 0-100% Charge Cost), home_cost_per_mile (Home Electricity Cost per Mile), monthly_home_bill (Estimated Monthly Home EV Electric Bill) using battery_kwh (Usable Battery Pack Capacity (kWh) in kWh), home_kwh_rate (Home Electric Rate ($/kWh)), public_kwh_rate (Public DC Fast Charge Rate ($/kWh)), rated_range_miles (Full Battery Driving Range in miles), monthly_miles_driven (Monthly Driving Distance in miles/mo). 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 (EV) Charging Cost & Range 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-charging-cost"

    • category (string): "physics"

    • name (string): "Electric Vehicle (EV) Charging Cost & Range Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.home_full_charge (Home Full 0-100% Charge Cost): Formatted display string (e.g. '$13.33')

      • metrics.public_full_charge (Public Fast 0-100% Charge Cost): Formatted display string (e.g. '$35.00')

      • metrics.home_cost_per_mile (Home Electricity Cost per Mile): Formatted display string (e.g. '$0.043 / mile')

      • metrics.monthly_home_bill (Estimated Monthly Home EV Electric Bill): Formatted display string (e.g. '$51.60 / 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_ev_charging_cost"
  }
}

Input Schema

NameRequiredDescriptionDefault
battery_kwhNoUsable Battery Pack Capacity (kWh) (kWh). Tesla Model 3/Y ≈ 75-82 kWh, F-150 Lightning ≈ 131 kWh. Default: 75. Min: 15. Max: 220.
home_kwh_rateNoHome Electric Rate ($/kWh). US national average: ~$0.16/kWh. Default: 0.16. Min: 0.04. Max: 0.7.
public_kwh_rateNoPublic DC Fast Charge Rate ($/kWh). Tesla Supercharger / Electrify America: ~$0.35 - $0.48/kWh. Default: 0.42. Min: 0.15. Max: 0.85.
rated_range_milesNoFull Battery Driving Range (miles). EPA estimated range on full charge. Default: 310. Min: 80. Max: 600.
monthly_miles_drivenNoMonthly Driving Distance (miles/mo). Average commute and road trips. Default: 1200. Min: 100. Max: 10000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools