rotate_stl

Cancel the currently running print job. Sends an UpdateState MQTT command with state: "stop". Not resumable — use pauseprint if you may want to continue.

Translate the model so the center of its bounding box sits at the world origin (0, 0, 0). Useful before applying transformations or exporting for use in another tool.

Clear HMS or print error state on the printer. Sends Bambu's cleanprinterror MQTT command.

Delete a single file from the printer's SD card via FTPS. Destructive. Requires confirm: true — without it the call returns status: "skipped" and does not contact the printer. Path traversal segments (..) are rejected. Only files under cache/, timelapse/, and logs/ can be deleted.

Add solid geometry underneath the model to increase its base height. Useful for improving bed adhesion on models with a small or unstable footprint.

Read the live AMS inventory and resolve each loaded tray to Bambu Studio

Retrieve current printer state including temperatures, print progress, layer count, time remaining, and AMS slot data. Internally sends a pushall MQTT command to force a fresh status report before reading cached state.

Inspect the slicer settings embedded in a saved 3MF template or in an extracted JSON/config profile without slicing anything.

Inspect an STL file without modifying it. Returns bounding box dimensions, face count, vertex count, and model center.

Identify the largest flat surface on the model and rotate the model so that face is oriented downward on the XY plane (Z = 0). This is a common preparation step before slicing to minimize the need for supports.

List object IDs from a sliced 3MF plate. Use this before skipobjects so you pass real Bambu object IDs instead of display-order guesses.

List files stored on the printer's SD card. Scans the cache/, timelapse/, and logs/ directories and returns both a flat list and a directory-grouped breakdown.

List saved templates from the local registry directory. You can override the registry root with BAMBUTEMPLATEDIR.

Merge vertices that are closer together than the specified tolerance. This can close small gaps in a mesh and slightly reduce file size. Useful as a cleanup step before slicing.

Pause the currently running print job. Sends an UpdateState MQTT command with state: "pause". Resumable via resumeprint.

The primary tool for starting a Bambu print. Recommended input: a pre-sliced .gcode.3mf exported from Bambu Studio — see docs/SLICING.md. This tool handles the complete workflow:

High-level wrapper for a prepared two-part dog-collar-charm workflow. This tool is intentionally specialized: it expects a prepared two-part charm project and applies a fixed tray policy.

the profile path the MCP will use for

Trigger a Bambu AMS RFID re-read for one AMS slot. This can move AMS filament; use it only when the printer is idle and unloaded.

Dry-run the AMS match without uploading or starting a print. The tool reads Metadata/plate<n>.json and Metadata/sliceinfo.config, then compares required trayinfoidx values against live AMS trays.

Resume a paused print job. Sends an UpdateState MQTT command with state: "resume".

Copy a local 3mf, json, or .config file into the template registry and register it under a reusable template name.

Scale an STL model along individual axes. Omit any axis to leave it unchanged (defaults to 1.0).

Set H2/P2 airduct mode to cooling or heating. This is intended for supported printers only.

Start or stop the AMS filament drying cycle on heated AMS units (AMS Pro / AMS-HT). The action parameter accepts start or stop. The amsid must be an integer from 0 to 3.

Set a printer fan speed from 0 to 100 percent. Accepted fan values are part, auxiliary, chamber, 1, 2, and 3.

Set a printer light node mode. Common Bambu firmware reports the chamber light as chamberlight; valid modes are on, off, and flashing.

Set the active print speed mode. Accepted mode values are silent, standard, sport, ludicrous, or their numeric equivalents 1, 2, 3, and 4.

Set the target temperature for the bed or nozzle. Dispatches an M140 (bed) or M104 (nozzle) G-code command via MQTT. Valid range is 0 to 300 degrees Celsius. Accepted values for component are bed, nozzle, extruder, tool, and tool0.

Skip specific object IDs during a running multi-object print. Use list3mfplateobjects on the sliced 3MF to find the IDs first.

Slice an STL or 3MF file using an external slicer and return the path to the output file. The output is a sliced 3MF (for BambuStudio and OrcaSlicer) or a G-code file (for PrusaSlicer, Cura, Slic3r).

Slice an STL or 3MF using a named template from the local registry. This is a higher-level wrapper over slicestl for template-based workflows.

Start printing a .gcode file that is already on the printer's SD card. Do not use this for .3mf files -- use print3mf instead, which handles the projectfile MQTT command with proper metadata.

, summary.resolvedprofileslots,

for A1, A1 mini, P1S, P1P. Native protocol per OpenBambuAPI/video.md: TLS on port 6000, 80-byte auth packet (bblp + access token), repeating 16-byte frame header + JPEG payload.

Upload a local file (G-code or 3MF) to the printer. If print is true and the file is a .gcode file, startprintjob is called automatically after a successful upload. For .3mf files, upload completes normally but you must use print3mf to initiate the print (which handles plate selection and metadata).

Write G-code content from a string directly to the printer's cache/ directory. The content is written to a temporary file and uploaded via FTPS.

boolean