fleet_status
Read-only
Retrieve a live snapshot of every fleet printer, including connection, operational state, and temperatures; optionally group the same printers by site.
Instructions
Get live status of all fleet printers (state, temps, connection — current snapshot).
The multi-machine view is a fleet feature. For ONE printer — which is
the single-printer experience at every tier — use ``printer_status``
(``detail="lite"`` for the cheap version), ``printer_snapshot`` or
``monitor_print``; each takes a ``printer_name`` and none of them is
tier-gated, so any machine you own can be inspected and stopped
whatever your licence.
For historical analytics (success rates, throughput), use ``fleet_analytics``.
Returns a list of printer snapshots including name, backend type,
connection status, operational state, and temperatures. Printers
that fail to respond are reported as offline rather than raising.
A printer the person marked with ``set_machine_repair`` carries a
``repair`` block (needs repair since, or repaired at and what), and
``needs_repair_printers`` lists the ones out of service: routing does
not choose them, though they may read as idle.
Args:
by_site: Also group the same printers by the site each one is at
(``update_printer_site``; printers with no site fall under
``"unassigned"``). When the plan includes it the answer adds
``sites`` (per site: ``printers``, ``count``, ``idle``, ``busy``,
``needs_repair``) and ``site_count``; otherwise the flat answer
comes back with one ``note``, never a refusal.
If no printers are registered yet, the current adapter (from env config)
is auto-registered as "default".
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": "fleet_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by_site | No | Also group the same printers by the site each one is at (``update_printer_site``; printers with no site fall under ``"unassigned"``). When the plan includes it the answer adds ``sites`` (per site: ``printers``, ``count``, ``idle``, ``busy``, ``needs_repair``) and ``site_count``; otherwise the flat answer comes back with one ``note``, never a refusal. Default: false. |