slice_with_template
Slice an STL or 3MF using a named process template from the local registry, with machine presets taken from the selected Bambu model and nozzle diameter.
Instructions
Slice an STL or 3MF with a named template from the local template registry (BAMBU_TEMPLATE_DIR). The template supplies process settings; the machine preset still comes from bambu_model and nozzle_diameter.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | Bambu-compatible slicing: uniform scale factor applied before slicing (1.0 = original size). | |
| orient | No | Bambu-compatible slicing: auto-orient for printability (--orient). | |
| rotate | No | Bambu-compatible slicing: Z-axis rotation in degrees before slicing. | |
| arrange | No | Bambu-compatible slicing: auto-arrange objects on the plate (--arrange). Set false to keep an existing layout. | |
| bed_type | No | Bambu-compatible slicing: build plate type (default: BED_TYPE or textured_plate). | |
| min_save | No | Bambu-compatible slicing: write a smaller output 3MF (--min-save). | |
| rotate_x | No | Bambu-compatible slicing: X-axis rotation in degrees before slicing. | |
| rotate_y | No | Bambu-compatible slicing: Y-axis rotation in degrees before slicing. | |
| stl_path | Yes | Path to the STL or 3MF file to slice | |
| uptodate | No | Bambu-compatible slicing: refresh 3MF preset configs to the installed slicer version (--uptodate). | |
| bambu_model | No | Bambu Lab printer model. Required for bambustudio and orcaslicer-bambulab (elicited or read from BAMBU_MODEL when omitted); passing it with orcaslicer selects the Bambu-compatible path. The installed slicer must contain the exact model/nozzle preset. | |
| nozzle_type | No | Bambu-compatible slicing: the hotend nozzle material installed on the printer (default: BAMBU_NOZZLE_TYPE, else the model preset's stock nozzle, usually stainless_steel; X1C/X1E presets use hardened_steel). Printing compares it with the printer's reported nozzle. | |
| repetitions | No | Bambu-compatible slicing: print N identical copies (--repetitions). | |
| slice_plate | No | Bambu-compatible slicing: plate number to slice; 0 slices all plates (default). | |
| slicer_path | No | Path to the slicer executable (default: value from env). Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1. | |
| slicer_type | No | Type of slicer to use (prusaslicer, cura, slic3r, orcaslicer, orcaslicer-bambulab, bambustudio). Use orcaslicer-bambulab for the FULU fork. bambustudio and orcaslicer-bambulab (and orcaslicer with bambu_model) export a sliced 3MF. | |
| skip_objects | No | Bambu-compatible slicing: comma-separated object indices to skip, e.g. '3,5,10'. | |
| template_dir | No | Template directory override when resolving template_name (default: BAMBU_TEMPLATE_DIR or ~/Sync/bambu/templates). | |
| clone_objects | No | Bambu-compatible slicing: comma-separated clone counts per object index, e.g. '1,3,1,10'. | |
| ensure_on_bed | No | Bambu-compatible slicing: lower floating models onto the bed (--ensure-on-bed). | |
| template_name | Yes | Named template from the local registry (required). | |
| allow_mix_temp | No | Bambu-compatible slicing: allow filaments with different temperature requirements on one plate. | |
| load_filaments | No | Bambu-compatible slicing: filament profile JSON paths in slot order, ';'-separated. One profile applies to every project slot; otherwise supply one per slot. | |
| slicer_profile | No | Explicit process profile that overrides the named template only when provided in this call. | |
| nozzle_diameter | No | Nozzle diameter in mm (default: NOZZLE_DIAMETER or 0.4). Selects the '<model> <diameter> nozzle' machine preset. | |
| enable_timelapse | No | Bambu-compatible slicing: insert timelapse parking moves (--enable-timelapse). | |
| filament_colours | No | Bambu-compatible slicing: one #RRGGBB per filament slot, ';'-separated. Defaults to the input 3MF's colours, then each profile's colour. | |
| filament_profile | No | Filament profile path(s), ';'-separated in slot order, loaded with --load-filaments (default: FILAMENT_PROFILE/SLICER_FILAMENT_PROFILE env). Alias of load_filaments. | |
| load_filament_ids | No | Bambu-compatible slicing: comma-separated filament IDs mapping load_filaments to objects, e.g. '1,2,3,1'. | |
| template_3mf_path | No | Bambu-compatible slicing: 3MF or profile whose embedded slicer settings are reused as the process profile (default: BAMBU_TEMPLATE_3MF_PATH). An explicit slicer_profile takes precedence. | |
| skip_modified_gcodes | No | Bambu-compatible slicing: ignore custom G-code embedded in an input 3MF (--skip-modified-gcodes). |