Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_offgrid_generator_fuel

Calculate hourly fuel consumption, tank runtime, and cost per kWh for off-grid diesel, propane, or natural gas generators using rated kW, load percentage, tank capacity, and fuel price.

Instructions

Off-Grid Diesel & Propane Generator Fuel Consumption Calculator. Calculate hourly fuel consumption in gallons, run-time on tank, and cost per kilowatt-hour for diesel, propane, and natural gas standby generators. Discipline: ENERGY. Governing mathematical model / formula: Diesel Fuel Burn ≈ 0.07 × Rated kW (at 50% load) to 0.08 × Rated kW (at 100% load) gal/hr.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of hourly_burn_rate (Hourly Fuel Consumption Rate), tank_runtime_hours (Continuous Runtime on Tank), hourly_fuel_cost (Operating Cost per Hour), cost_per_kwh_gen (Cost per Generated kWh) using generator_rated_kw (Generator Rated Output (kW) in kW), electrical_load_pct (Average Operating Load (%) in %), fuel_type (Fuel Type (1 = Diesel, 2 = Propane LPG, 3 = Natural Gas)), fuel_tank_capacity (Fuel Tank Capacity (Gallons) in gal), fuel_cost_per_unit (Fuel Price ($/Gallon or $/Therm)). 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 'Off-Grid Diesel & Propane Generator Fuel Consumption 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): "offgrid-generator-fuel"

    • category (string): "energy"

    • name (string): "Off-Grid Diesel & Propane Generator Fuel Consumption Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.hourly_burn_rate (Hourly Fuel Consumption Rate): Formatted display string (e.g. '1.40 gal/hr')

      • metrics.tank_runtime_hours (Continuous Runtime on Tank): Formatted display string (e.g. '35.7 hours')

      • metrics.hourly_fuel_cost (Operating Cost per Hour): Formatted display string (e.g. '$5.39 / hr')

      • metrics.cost_per_kwh_gen (Cost per Generated kWh): Formatted display string (e.g. '$0.54 / kWh')

    • 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_offgrid_generator_fuel"
  }
}

Input Schema

NameRequiredDescriptionDefault
fuel_typeNoFuel Type (1 = Diesel, 2 = Propane LPG, 3 = Natural Gas). 1: Diesel, 2: Propane (gal/hr), 3: Natural Gas (therms/hr). Default: 1. Min: 1. Max: 3.
fuel_cost_per_unitNoFuel Price ($/Gallon or $/Therm). Current local price per gallon. Default: 3.85. Min: 1. Max: 10.
fuel_tank_capacityNoFuel Tank Capacity (Gallons) (gal). Volume of base tank or auxiliary fuel storage. Default: 50. Min: 5. Max: 1000.
generator_rated_kwNoGenerator Rated Output (kW) (kW). Continuous prime or standby power rating. Default: 20. Min: 3. Max: 250.
electrical_load_pctNoAverage Operating Load (%) (%). 50% is standard nominal operating load. Default: 50. Min: 25. Max: 100.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools