omni_mulch
Calculate cubic yards and bag or truck-load counts of mulch or topsoil for landscape beds from bed area and depth, eliminating manual arithmetic errors.
Instructions
Mulch & Soil Volume Calculator. Calculate cubic yards and 2 cu ft / 3 cu ft bag counts of hardwood bark mulch or garden topsoil for landscape beds. Discipline: CONSTRUCTION. Governing mathematical model / formula: Cubic Yards = [Bed Area (sq ft) × Depth (in)] / 324.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of cubic_yards (Bulk Mulch (Cubic Yards)), bags_2cuft (Standard 2 cu ft Bags), bags_3cuft (Large 3 cu ft Bags), truck_beds (Pickup Truck Beds (~2 cu yd)) using bed_area (Total Garden Bed Area in sq ft), mulch_depth (Mulch Depth in 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 'Mulch & Soil Volume 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): "mulch"
category (string): "construction"
name (string): "Mulch & Soil Volume Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.cubic_yards (Bulk Mulch (Cubic Yards)): Formatted display string (e.g. '4.17 cu yd')
metrics.bags_2cuft (Standard 2 cu ft Bags): Formatted display string (e.g. '57 bags')
metrics.bags_3cuft (Large 3 cu ft Bags): Formatted display string (e.g. '38 bags')
metrics.truck_beds (Pickup Truck Beds (~2 cu yd)): Formatted display string (e.g. '3 loads')
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_mulch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bed_area | No | Total Garden Bed Area (sq ft). Combined area of garden beds. Default: 450. Min: 10. Max: 10000. | |
| mulch_depth | No | Mulch Depth (in). 2-3 inches recommended for weed control. Default: 3. Min: 1. Max: 6. |