monitor_print_vision
Captures a webcam snapshot and structured print metadata for AI visual inspection, helping detect failures and optionally auto-pause an in-progress 3D print.
Instructions
Snapshot + structured data for AI visual inspection of an in-progress print.
Use when analyzing camera images for print failures. Returns webcam image
(base64 or saved file) alongside structured metadata (temps, progress,
phase, cost estimate, failure hints). Can auto-pause on detected issues.
For a quick text status report, use ``monitor_print`` instead.
For persistent background monitoring, use ``watch_print``.
Args:
printer_name: Target printer. Omit for the default printer.
include_snapshot: Whether to capture a webcam snapshot (default True).
save_snapshot: Optional path to save the snapshot image.
failure_type: Optional detected failure type (e.g. "spaghetti",
"layer_shift", "warping"). Reported by the agent after visual
inspection of a previous snapshot.
failure_confidence: Confidence score (0.0-1.0) of the failure detection.
auto_pause: If True, pause the print when the reported
``failure_confidence`` is high enough; the reply says
whether it did. Defaults to the ``KILN_VISION_AUTO_PAUSE``
environment variable (off).
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. 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_vision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_pause | No | If True, pause the print when the reported ``failure_confidence`` is high enough; the reply says whether it did. Defaults to the ``KILN_VISION_AUTO_PAUSE`` environment variable (off). | |
| 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. Read by the inline monitor's result hook (``kiln.local_monitor``), not here. Default: false. | |
| failure_type | No | Optional detected failure type (e.g. "spaghetti", "layer_shift", "warping"). Reported by the agent after visual inspection of a previous snapshot. | |
| printer_name | No | Target printer. Omit for the default printer. | |
| save_snapshot | No | Optional path to save the snapshot image. | |
| include_snapshot | No | Whether to capture a webcam snapshot (default True). Default: true. | |
| failure_confidence | No | Confidence score (0.0-1.0) of the failure detection. |