Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_excavation_trench

Calculate trench bank and loose cubic yards, bottom area, and dump truck haul loads from length, width, depth, and soil swell inputs to avoid manual arithmetic errors.

Instructions

Trench Excavation & Soil Swell Calculator. Calculate trench volume in cubic yards, bank cubic yards (BCY) vs loose cubic yards (LCY), and haul-off dump truck loads. Discipline: CONSTRUCTION. Governing mathematical model / formula: Loose Volume (LCY) = Bank Volume (BCY) × (1 + Swell Factor / 100).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of bank_cuyd (In-Ground Volume (BCY)), loose_cuyd (Excavated Loose Volume (LCY)), truck_loads (10-Yard Dump Truck Hauls), trench_sqft (Trench Bottom Surface) using length (Trench Length in ft), width (Trench Width in ft), depth (Trench Depth in ft), soil_swell (Soil Swell Factor 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 'Trench Excavation & Soil Swell 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): "excavation-trench"

    • category (string): "construction"

    • name (string): "Trench Excavation & Soil Swell Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.bank_cuyd (In-Ground Volume (BCY)): Formatted display string (e.g. '29.63 cu yd')

      • metrics.loose_cuyd (Excavated Loose Volume (LCY)): Formatted display string (e.g. '37.04 cu yd')

      • metrics.truck_loads (10-Yard Dump Truck Hauls): Formatted display string (e.g. '4 truckloads')

      • metrics.trench_sqft (Trench Bottom Surface): Formatted display string (e.g. '200.0 sq ft')

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

Input Schema

NameRequiredDescriptionDefault
depthNoTrench Depth (ft). Depth in feet (OSHA mandates shoring over 5ft). Default: 4. Min: 1. Max: 20.
widthNoTrench Width (ft). Bucket width or trench width in feet. Default: 2. Min: 0.5. Max: 20.
lengthNoTrench Length (ft). Total length of trench excavation. Default: 100. Min: 5. Max: 2000.
soil_swellNoSoil Swell Factor (%). Clay/dirt swells 20-30% when disturbed and uncompacted. Default: 25. Min: 10. Max: 50.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools