add_feature_during_print
Add a new shape to a paused 3D print and finish it with the feature, then inspect the result in an interactive 3D stage.
Instructions
Add a new shape to a paused print, then finish the print with it (Pro). Opens Kiln's interactive inline 3D stage on the result (orbit/zoom panel in MCP Apps hosts; hosted sessions add a browser stage link).
INLINE 3D STAGE: on success this tool opens Kiln's interactive 3D stage — an inline viewer panel the user can orbit, zoom, and turn over — in hosts that render MCP Apps panels (Kiln's hosted connection attaches a browser stage link for hosts that don't). Oversized meshes are decimated automatically for the stage; the PNG preview is the floor, not the whole experience.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"feature": "<feature>",
"gcode_path": "<gcode_path>",
"current_layer": "<current_layer>"
},
"name": "add_feature_during_print"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orient | No | ``"auto"`` / ``"identity"`` / ``"upright"``. ``"auto"`` lets the slicer choose. Default: "auto". | |
| feature | Yes | Normie spec ("a small top hat", "/path/to/hat.stl", "library:halo_v2", etc.). | |
| bed_temp | No | Bed temperature for the same three, read and checked the same way. The feature slice heats the bed itself, so this is the bed the rest of the print runs at. | |
| placement | No | ``[x, y]`` bed coords where the feature's XY centroid lands. ``None`` = resolved bed centre. | |
| gcode_path | Yes | Original sliced .gcode of the in-flight job. | |
| output_dir | No | Engine session directory. Default: "". | |
| pause_z_mm | No | Physical Z of the pause point in mm. REQUIRED if the source gcode's layer markers don't carry Z comments; the engine will error with ``FEATURE_PAUSE_Z_UNKNOWN`` in that case if this is left ``None``. | |
| hotend_temp | No | Nozzle temperature for the feature slice, the resume pre-heat and Bambu 3MF metadata. Leave unset to use the print's own (read off ``gcode_path`` at the pause). A value that differs from the print's own is kept and said in ``warnings``. | |
| printer_name | No | Printer identifier. Default: "default". | |
| current_layer | Yes | 1-indexed layer the printer is paused at. | |
| filament_type | No | The print's material, for Bambu 3MF metadata and material-routing provenance. Leave it out and Kiln reads the print's own material; when nothing says which, the call is refused (``PRINT_MATERIAL_UNKNOWN``). | |
| printer_z_known | No | REQUIRED ``True`` (same safety gate as ``decorate_during_print``). Default: false. | |
| source_3mf_path | No | Optional original .3mf for thumbnail pass-through. Default: "". | |
| target_ams_slot | No | Optional 0-indexed AMS slot that must feed the injected feature. ``-1`` means no explicit material route was requested. Default: -1. | |
| parent_design_id | No | Optional design this print derives from, recorded in the session's provenance. Default: "". | |
| printer_bed_size | No | Explicit ``[x, y]`` in mm. If omitted, Kiln resolves ``printer_name`` through bundled printer intelligence and fails closed when the bed size is unknown. | |
| require_ams_match | No | When True, refuse to emit the feature resume unless AMS status proves the requested material route. Default: true. | |
| slicer_config_ini | No | Path to a prusaslicer .ini. Empty = use the slicer's default / installed profile discovered by the auto-discovery. Default: "". | |
| target_filament_type | No | Optional expected tray material. Without an explicit slot, Kiln resolves exactly one matching loaded AMS tray from ``ams_status`` or fails closed. Default: "". | |
| first_layer_height_mm | No | First-layer height of the sliced feature — the slicer rests this on top of the paused print's top face. Default: 0.2. | |
| target_filament_color | No | Optional expected tray color (``#RRGGBB`` or a common name like ``blue``). Default: "". | |
| manual_material_change_confirmed | No | Non-Bambu safety gate for material/color changes. Set True only after the target material is loaded in the active feed path; otherwise Kiln refuses before emitting an artifact. Default: false. |