monitor_print
Get a one-shot, human-readable 3D printer status report covering progress, temperatures, speed, errors, cost estimate, ETA, and optional camera snapshot for quick checks.
Instructions
One-shot print status report (human-readable text: progress, temps, speed, cost, ETA).
Use for quick status checks. Returns a fixed-format text report with
progress, temps, speed, errors, cost estimate, camera snapshot, and
health commentary. For structured data + AI vision inspection, use
``monitor_print_vision``. For persistent background monitoring, use
``watch_print``.
This is the text report from the computer the printer is attached
to. When Kiln's hosted connector is also connected,
``monitor_printer`` there is the door for the inline live monitor and
camera; call that one to show the person a live panel. The report's
closing ``Live monitor:`` line says whether a panel came with THIS
result or where the live monitor is instead — repeat it as written.
:param printer_name: Target printer name. Omit for the default printer.
:param include_snapshot: Whether to capture and save a camera snapshot.
:param brief_id: Optional saved-goal id from ``design_session``. When
the brief resolves, the report appends a single ``Goal:`` line
with the design's duty and environment — so the agent watching
a print can answer "is this the right design for the goal?"
without a separate lookup. Best-effort: a missing kiln-pro
install or an unresolvable brief silently skips the line.
:param show_panel: Open the inline live monitor panel again even
though one opened by an earlier call is still live above. Pass
only when the person asks to see the panel again; the report
itself is unchanged. Read by the inline monitor's result hook
(``kiln.local_monitor``), not here.INLINE LIVE MONITOR: in apps that draw MCP Apps panels, this tool's result also carries Kiln's inline print monitor — a live panel with progress, temperatures, and the camera while a print runs. The result's own 'Live monitor:' line says whether that panel is open here, attached but unconfirmed, or not available in this app (then it names the web monitor instead); repeat what that line says and never tell the person a panel is open on the strength of this description. The panel polls the printer itself once open, so do not call this tool again to refresh it: later checks go through printer_status or first_layer_status, and a repeat while the panel is live returns the text report with a one-line card, not a second panel. Pass show_panel=True only when the person asks to see the panel again. Free with a Kiln sign-in; the text report below is always complete on its own.
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": "monitor_print"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brief_id | No | Optional saved-goal id from ``design_session``. When the brief resolves, the report appends a single ``Goal:`` line with the design's duty and environment — so the agent watching a print can answer "is this the right design for the goal?" without a separate lookup. Best-effort: a missing kiln-pro install or an unresolvable brief silently skips the line. Default: "". | |
| show_panel | No | Open the inline live monitor panel again even though one opened by an earlier call is still live above. Pass only when the person asks to see the panel again; the report itself is unchanged. Read by the inline monitor's result hook (``kiln.local_monitor``), not here. Default: false. | |
| printer_name | No | Target printer name. Omit for the default printer. | |
| include_snapshot | No | Whether to capture and save a camera snapshot. Default: true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |