Count or cost-total work orders
find_workordersCount maintenance work orders or total their costs by level, status, priority, failure class, and equipment category for building maintenance reporting.
Instructions
Count or cost-total maintenance work orders under fixed filters.
Use this for work-order / maintenance questions, e.g. "how many work orders on Level 2", "open work orders", "high-priority work orders on the 1st floor that service the heat pumps", "how much have we spent on HVAC work orders". All filters are optional and combine with AND.
Examples: - Work orders on Level 1: level='Level 1' - Open work orders: status='OPEN' - High-priority WSHP on Level 1: level='Level 1', asset_category='heat_pumps', priority='high' - HVAC maintenance spend: failure_class='HVAC', measure='cost'
Returns (count): {"measure": "count", "filters": {...}, "count": int, "breakdown_by_status": {status: int}}. Returns (cost): {"measure": "cost", "filters": {...}, "count": int, "total_cost": float, "total_labor_hours": float, "avg_cost": float}.
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": "find_workorders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Optional building level to restrict to. Omit for all levels. | |
| status | No | Optional work-order status (e.g. OPEN for open work orders). | |
| measure | No | 'count' (default) returns how many plus a status breakdown; 'cost' returns spend/labor totals (total_cost, total_labor_hours, avg_cost). | count |
| priority | No | Optional priority as a word: high (most urgent), normal, or low. | |
| failure_class | No | Optional failure class (the system the work order is against). | |
| asset_category | No | Optional category of the equipment a work order services (e.g. 'heat_pumps' = the WSHP units). | |
| reported_by_role | No | Optional role that reported the work order. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||