bulc_list_evac_agents
List evacuation agents with positions and properties in BULC Building Designer to analyze fire simulation data by filtering floor levels or rooms.
Instructions
List all evacuation agents with their positions and properties.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Filter by floor level. Omit for all levels. | |
| room | No | Filter by room name or ID |
Implementation Reference
- src/tools/evac.ts:936-942 (handler)Handler logic for 'bulc_list_evac_agents' tool: validates input using ListEvacAgentsSchema and sends 'list_evac_agents' command to BULC client.case "bulc_list_evac_agents": { const validated = ListEvacAgentsSchema.parse(args); result = await client.sendCommand({ action: "list_evac_agents", params: validated, }); break;
- src/tools/evac.ts:765-768 (schema)Zod schema for validating input parameters (level, room) of the 'bulc_list_evac_agents' tool.const ListEvacAgentsSchema = z.object({ level: z.number().int().optional(), room: z.string().optional(), });
- src/tools/evac.ts:183-204 (registration)Tool registration/definition in evacTools array, providing name, description, inputSchema for MCP tool listing.{ name: "bulc_list_evac_agents", description: "List all evacuation agents with their positions and properties.", inputSchema: { type: "object" as const, properties: { level: { type: "integer", description: "Filter by floor level. Omit for all levels.", }, room: { type: "string", description: "Filter by room name or ID", }, }, }, annotations: { readOnlyHint: true, destructiveHint: false, }, },
- src/index.ts:135-137 (registration)Dispatch routing in main MCP handler: routes 'bulc_*evac*' tools to handleEvacTool.if (name.startsWith("bulc_") && name.includes("evac")) { return await handleEvacTool(name, safeArgs); }
- src/index.ts:54-58 (registration)MCP server registration of allTools (includes evacTools) for listTools request.server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: allTools, }; });