Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_rational_method_stormwater

Calculate peak stormwater runoff discharge using the Rational Method (Q = C·I·A) for culvert sizing and detention basin planning from basin area, runoff coefficient, and rainfall intensity.

Instructions

Stormwater Runoff Peak Discharge Calculator (Rational Method Q = C·I·A). Calculate watershed peak stormwater runoff discharge in cubic feet per second (CFS) for drainage culverts and retention detention basin sizing. Discipline: ENGINEERING. Governing mathematical model / formula: Peak Runoff Q = C · I · A | 1 Acre-Inch/Hour ≈ 1.008 CFS.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of peak_discharge_cfs (Peak Stormwater Discharge (Q)), required_culvert_diameter_in (Recommended Culvert Diameter), rainfall_volume_gallons_min (Peak Inflow Rate (GPM)), impervious_coverage_rating (Surface Imperviousness) using runoff_coefficient_c (Runoff Coefficient (C)), rainfall_intensity_in_hr (Design Rainfall Intensity (I in Inches/Hour) in in/hr), drainage_basin_acres (Contributing Drainage Basin Area (Acres) in acres). 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.

  • SIBLING ROUTING: Use this dedicated specialist tool for 'Stormwater Runoff Peak Discharge Calculator (Rational Method Q = C·I·A)' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.

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): "rational-method-stormwater"

    • category (string): "engineering"

    • name (string): "Stormwater Runoff Peak Discharge Calculator (Rational Method Q = C·I·A)"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.peak_discharge_cfs (Peak Stormwater Discharge (Q)): Formatted display string (e.g. '51.8 CFS')

      • metrics.required_culvert_diameter_in (Recommended Culvert Diameter): Formatted display string (e.g. '36-Inch RCP Pipe')

      • metrics.rainfall_volume_gallons_min (Peak Inflow Rate (GPM)): Formatted display string (e.g. '23,248 Gallons / Minute')

      • metrics.impervious_coverage_rating (Surface Imperviousness): Formatted display string (e.g. 'High Impervious Commercial Site')

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

Input Schema

NameRequiredDescriptionDefault
drainage_basin_acresNoContributing Drainage Basin Area (Acres) (acres). Catchment watershed area draining to point. Default: 14.5. Min: 0.2. Max: 200.
runoff_coefficient_cNoRunoff Coefficient (C). Asphalt/Roofs = 0.85 - 0.95; Lawns/Grass = 0.15 - 0.25; Commercial = 0.70 - 0.85. Default: 0.85. Min: 0.1. Max: 0.95.
rainfall_intensity_in_hrNoDesign Rainfall Intensity (I in Inches/Hour) (in/hr). NOAA Atlas 14 precipitation rate for design storm (e.g. 10-year or 25-year event). Default: 4.2. Min: 0.5. Max: 12.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools