List every simulated machine with its latest reading and state.

Returns { count, devices: [{ id, name, state, temperature_c, vibration_mm_s, timestamp }] }. Read only. Use this first to discover valid device ids for the other tools.

Return time ordered sensor readings for one device across a time window.

Inputs: device_id (required), start and end (epoch ms, optional, default last 15 minutes), step_ms (default 30000), limit and offset for pagination, response_format. Returns { device_id, start, end, step_ms, total, count, offset, has_more, next_offset?, readings: [{ timestamp, temperature_c, vibration_mm_s, state }] }. Read only.

Detect threshold crossings (temperature or vibration) over a time window.

Inputs: device_id (optional, omit to scan all devices), start and end (epoch ms, optional, default last 15 minutes), step_ms (default 30000), response_format. Returns { count, window, anomalies: [{ id, device_id, metric, started_at, ended_at, peak_value, threshold, sample_count }] }. A healthy machine returns no anomalies. Read only.

Inject a fault on a device so it becomes visible to get_telemetry and get_anomalies.

Inputs: device_id (required), fault_type ('overheat' | 'vibration' | 'combined', default 'overheat'), duration_seconds (default 300). The fault is treated as having started two minutes ago so it appears immediately in recent telemetry. Returns { fault: { id, device_id, type, started_at, ends_at, duration_ms }, message }. This tool mutates simulator state; it is not read only.