Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_solar_pv_sizing

Calculates required solar PV DC system size, panel count, roof area, and daily generation from annual kWh usage, peak sun hours, derate factor, and panel wattage.

Instructions

Solar PV System Sizing & DC kW Array Calculator. Determine the exact DC kilowatt rating and number of solar panels required to offset 100% of annual household or facility electrical consumption. Discipline: ENERGY. Governing mathematical model / formula: Required DC kW = Annual kWh Demand / (365 × Daily Peak Sun Hours × Derate Factor).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of system_size_kw (Recommended DC System Size), panel_count (Required Number of Panels), roof_area_sqft (Estimated Roof Space Required), daily_generation (Avg Daily AC Energy Produced) using annual_usage_kwh (Annual Electricity Usage (kWh) in kWh), peak_sun_hours (Daily Peak Sun Hours in hrs/day), derate_factor (System Performance Ratio), panel_wattage (Panel Rated Wattage (Watts DC) in W), target_offset_pct (Target Energy Offset (%) in %). 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 'Solar PV System Sizing & DC kW Array 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): "solar-pv-sizing"

    • category (string): "energy"

    • name (string): "Solar PV System Sizing & DC kW Array Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.system_size_kw (Recommended DC System Size): Formatted display string (e.g. '8.9 kW DC')

      • metrics.panel_count (Required Number of Panels): Formatted display string (e.g. '22 panels')

      • metrics.roof_area_sqft (Estimated Roof Space Required): Formatted display string (e.g. '430 sq ft')

      • metrics.daily_generation (Avg Daily AC Energy Produced): Formatted display string (e.g. '32.8 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_solar_pv_sizing"
  }
}

Input Schema

NameRequiredDescriptionDefault
derate_factorNoSystem Performance Ratio. Losses from inverter, wiring, dust, and temperature. Default: 0.82. Min: 0.65. Max: 0.95.
panel_wattageNoPanel Rated Wattage (Watts DC) (W). Rated nameplate capacity per solar module. Default: 410. Min: 300. Max: 650.
peak_sun_hoursNoDaily Peak Sun Hours (hrs/day). Average equivalent solar irradiance (kWh/m²/day). Default: 4.5. Min: 2.5. Max: 7.
annual_usage_kwhNoAnnual Electricity Usage (kWh) (kWh). Sum of 12 monthly electric bills. Default: 12000. Min: 2000. Max: 150000.
target_offset_pctNoTarget Energy Offset (%) (%). Desired percentage of electric bill to offset. Default: 100. Min: 25. Max: 150.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools