omni_electricity_cost
Calculate daily, monthly, and annual electricity costs and kWh usage for appliances using wattage, operating hours, and local utility rates, eliminating manual arithmetic errors.
Instructions
Electricity Cost & Appliance kWh Calculator. Calculate daily, monthly, and annual operating costs for any electrical appliance from wattage and local utility kWh rates. Discipline: CONSTRUCTION. Governing mathematical model / formula: Cost = [Watts × Hours Run / 1,000] × Utility Rate ($/kWh).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of monthly_cost (Monthly Electricity Cost), annual_cost (Annual Electricity Cost), daily_kwh (Daily Energy Consumption), monthly_kwh (Monthly Energy Consumption) using wattage (Appliance Wattage in watts), hours_per_day (Daily Operating Hours in hrs/day), kwh_rate (Electric Utility Rate in /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 'Electricity Cost & Appliance kWh 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): "electricity-cost"
category (string): "construction"
name (string): "Electricity Cost & Appliance kWh Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.monthly_cost (Monthly Electricity Cost): Formatted display string (e.g. '$57.60 / mo')
metrics.annual_cost (Annual Electricity Cost): Formatted display string (e.g. '$700.80 / yr')
metrics.daily_kwh (Daily Energy Consumption): Formatted display string (e.g. '12.0 kWh / day')
metrics.monthly_kwh (Monthly Energy Consumption): Formatted display string (e.g. '360.0 kWh / 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_electricity_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wattage | No | Appliance Wattage (watts). Nameplate wattage on appliance label. Default: 1500. Min: 1. Max: 15000. | |
| kwh_rate | No | Electric Utility Rate (/kWh). US average is ~$0.16/kWh. Default: 0.16. Min: 0.05. Max: 0.6. | |
| hours_per_day | No | Daily Operating Hours (hrs/day). Average hours running per 24-hour cycle. Default: 8. Min: 0.25. Max: 24. |