Technis

Returns a single device by ID if the user is authorized to access it (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Returns device status history if the user is authorized to access it (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Returns a paginated list of devices that the user is authorized to access. Use this tool when the user asks for a list of devices. Unless specified, deviceType should be omitted. (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Get a floor plan by its ID (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Get the active floor plan for a zone. Each zone has at most one active floor plan. (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Find floor plans across sites, optionally filtered by zone IDs (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Fetch metrics (visitor counts, occupancy, dwell time, air quality, sales KPIs, etc.) for authorized sites/zones/passages over a time range. ALWAYS specify both filter.start and filter.end (ISO-8601). If the user does not specify a time, default to T00:00:00 / T23:59:59. Set filter.timezone to the user's local timezone when their query implies local time ("today", "this week", etc.). RESPONSE SHAPE: array of { attributes: { siteId?, zoneId?, passageId?, timestamp?, siteName?, zoneName?, ... }, metrics: { <METRIC_KEY>: { data: number|null } }, timestamp: string }. Use enrichAttributes: true to get siteName/zoneName/passageName in attributes. QUERY PATTERNS — pick based on user intent: 1. Latest datapoint → groupBy ["timestamp","metric"], orderBy timestamp desc, limit 1–5, inputSampling AUTO. 2. Cumulative total over range → groupBy ["metric"] only, no orderBy/limit, inputSampling DAY or AUTO. Use the correct aggregation for the metric (SUM for counters, WEIGHTED_AVG for averages, AVG for sensors). 3. Timeseries for chart → groupBy ["timestamp","metric"], orderBy timestamp asc, limit 240–1440, inputSampling HOUR or DAY, paddingInterval "auto". 4. Zone/site breakdown → groupBy ["metric","zoneId"] or ["metric","siteId"], no orderBy, inputSampling AUTO. Add enrichAttributes: true to get names. 5. Ranking (top zones) → groupBy ["metric","zoneId"], orderBy by metric value desc, limit N. inputSampling speeds up queries significantly — always set it unless raw sub-minute data is strictly needed. (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Returns a single organization by ID if the user is authorized to access it (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Returns a paginated list of organizations that the user is authorized to access (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.

Returns a single passage by ID if the user is authorized to access it (Requires mcp:read permission). If an insufficient-permissions error is thrown, all tools with same required permission will fail. Tell the user that they need to request the permission.