unofficial-bambu-mcp
Provides tools for building, editing, slicing, and calibrating Bambu Studio projects, sending print files to Bambu Lab printers, reading printer status, and controlling compatible printers in LAN mode.
unofficial-bambu-mcp
Unofficial community project. Not affiliated with, endorsed by or supported by Bambu Lab. "Bambu Lab", "Bambu Studio", "Bambu Connect" and "Bambu Handy" are trademarks of their respective owners.
An MCP server that lets an AI assistant (Claude Code, Claude Desktop or any MCP client) build, edit, slice, check and calibrate Bambu Studio projects, using the official Bambu Studio you already have installed, and read your printer's status on the local network.
You talk, it does the slicer work:
"New P1S project: a 20 mm cube and the text 'DANI' in white on a black 2 mm tag."
"Open
~/Downloads/Gnome 3 Color.3mf, add a plate with two more gnomes, then convert it for the A1 mini.""I have eSUN PLA Basic in AMS slot 2: make a preset for it and the test prints to calibrate it."
"Before I start this 20-hour plate: which parts are likely to come off?"
"A pin came off at layer 4 and I skipped it: make me a project to reprint just that pin, with a brim."
"How is the print going? Which spool is it feeding from?"

A real session, sped up: every tool call, result and image comes from the server through MCP; only the requests are written for the demo (scripts/make_demo.py).
What it can do
Area | What you can do |
Projects | Create a project, or open any .3mf saved by Bambu Studio (2.x and older 1.6/1.7 files) or downloaded from MakerWorld / Printables: painted colors, modifiers, per-object settings, instances and plates are kept. Save without ever overwriting. |
Printers | All 14 Bambu Lab printers of Bambu Studio 2.8, tested end to end (project, arrange, slice, print file): A1 mini, A1, A2L, P1P, P1S, P2S, X1, X1 Carbon, X1E, H2S and the two-nozzle H2D, H2D Pro, H2C and X2D (filaments go to a nozzle automatically, as Bambu Studio does). Switch printer and objects are re-arranged for the new bed. New projects use the build plate you picked in Bambu Studio for that printer. |
Filaments | AMS slots with preset and color, your own user presets included. |
Plates & objects | Import STL, OBJ, 3MF; boxes, cylinders, cones, spheres and text (with a base in another color). Move, rotate, scale, mirror, lay flat, auto orient (least support, enough on the bed), duplicate, fill the plate with copies, split into objects or parts, merge objects into one, mesh boolean (holes, unions, intersections) with painted colors kept, filament per object or part, per-object settings, closed-solid check. Object ids stay the same while you work. |
Arranging |
|
Cutting |
|
Modifiers | Box or round parts: modifiers with their own settings ("the top 5 mm at 100 % infill"), negative parts (holes for magnets and screws), support blockers and enforcers. |
Settings | Read or change any Bambu Studio setting, per filament slot when it applies, with a warning when a value cannot apply (e.g. a textured-plate temperature on a smooth plate). |
Presets | Save the project's changes as Bambu Studio user presets: filament ( |
Text & logos |
|
Measuring |
|
Height ranges & plates |
|
Painting |
|
Purge volumes |
|
Slicing | Bambu Studio command line: time, grams and cost per filament, filament changes, pauses, layers and warnings per plate. Empty plates are skipped. |
Previews | Images of a plate (iso or top, zoom, painted colors, object labels) and of any sliced layer, so the assistant checks its own work. |
Print risks |
|
Brim ears |
|
Reprints |
|
Calibration | Temperature tower, flow rate test (pass 1 and 2), pressure advance tower, max volumetric speed test, retraction test, VFA test (wall speeds), first-layer test, for any filament. Save the result as a Bambu Studio filament preset: a new filament gets its own id, like Bambu Studio's Create Filament, so you can pick it for an AMS slot; updating it later keeps that id. |
Layer actions | Pause at a height (magnets, nuts), filament change at a height, or any G-code at a height. |
Printing |
|
Developer Mode (LAN farms) | For printers in LAN-only mode with Developer Mode, where Bambu firmware accepts commands from other programs: |
Printer status |
|
Camera & SD card |
|
All 87 tools with their parameters: docs/TOOLS.md.
Related MCP server: Bambu Project QA MCP
Tested on
Real hardware: macOS, Bambu Studio 2.8.2, a P1S with two AMS units, in normal cloud mode:
every tool through a real MCP client, on projects made from scratch and on MakerWorld / Printables downloads (painted 6-color models, multi-part assemblies, 3-plate projects, files from Bambu Studio 1.6 and 1.7);
printed: temperature towers and flow tests for two third-party filaments (eSUN PLA Basic black and white), whose presets were made and tuned through the server; the print hand-off to Bambu Studio; live status during prints.
The pressure advance tower, the max volumetric speed test and the retraction test are checked by slicing (the G-code is inspected) but have not been printed yet.
Windows and Linux: on every change to main, CI installs Bambu Studio 2.8.2 (the portable zip on Windows, the
AppImage on Debian 13) and runs the whole test suite, slicing and print files included, plus a smoke run. Unit tests
run on Windows, macOS and Linux with Python 3.10 and 3.13. On Linux the AppImage takes FFmpeg 7 and WebKitGTK 4.1
from the system (Debian 13, Ubuntu 24.10 or newer); set BAMBU_STUDIO_EXE if Bambu Studio is somewhere else.
Printers: all 14 Bambu Lab printers of Bambu Studio 2.8 go through the MCP from a new project to a print file (A1 mini, A1, A2L, P1P, P1S, P2S, X1, X1 Carbon, X1E, H2S, H2C, H2D, H2D Pro, X2D); only the P1S has printed. The Developer Mode tools were checked against a printer in cloud mode (refused, with the right answer) but never started a print on one in Developer Mode.
Printing and your printer
Bambu firmware (2025 and later) accepts commands from other programs only when the printer is in LAN-only mode with Developer Mode on, which turns off the cloud and Bambu Handy. In normal cloud mode it refuses them, so this server:
reads the printer status (allowed in cloud mode), with the LAN access code Bambu Studio already saved;
hands the print over to Bambu Studio or Bambu Connect, where you press Print;
does not start prints, set AMS slots or skip objects in cloud mode: you do that in Bambu Studio, Bambu Handy or on the printer. For printers in LAN-only mode with Developer Mode (print farms) it can, always after you confirm with the code it gives (see the Developer Mode row above).
More in docs/printing.md.
Quick start
Requirements: uv and Bambu Studio. The package comes from
PyPI: uvx downloads it the first time (and Python 3.10+ if you
do not have it), so there is nothing to clone or install by hand.
It is a standard MCP server (stdio), so any MCP client that runs local servers can use it. It was developed and tested with Claude Code; the other clients below take the same command in their own config file.
Claude Code
claude mcp add bambu -- uvx unofficial-bambu-mcpClaude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), Windsurf
(~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"bambu": {
"command": "uvx",
"args": ["unofficial-bambu-mcp"]
}
}
}OpenAI Codex CLI (~/.codex/config.toml):
[mcp_servers.bambu]
command = "uvx"
args = ["unofficial-bambu-mcp"]VS Code (GitHub Copilot agent mode, .vscode/mcp.json):
{ "servers": { "bambu": { "type": "stdio", "command": "uvx", "args": ["unofficial-bambu-mcp"] } } }If a desktop app cannot find
uvx(spawn uvx ENOENT), put its full path as the command:which uvxprints it.uvxkeeps the version it downloaded: writeunofficial-bambu-mcp@latestinstead to get new releases.From a clone (for development):
uv run --directory /path/to/unofficial-bambu-mcp unofficial-bambu-mcp.The ChatGPT app only connects to remote MCP servers, and this one has to run on the computer with Bambu Studio.
Then ask: "What version of Bambu Studio do I have, and which printers can you use?"
Configuration (optional)
Variable | Default | Meaning |
|
| Where projects, sliced files and print files are saved |
| auto-detected | Path of the Bambu Studio executable |
| auto-detected | Bambu Studio data folder (with |
| auto-detected | Bambu Studio resources folder (with |
|
| Where a copy of a user preset goes before it is changed, renamed or deleted |
| from Bambu Studio | Printer for |
How it works
Bambu Studio has no plugin or scripting API. This server works on the project file (.3mf, the format Bambu Studio saves) and calls the Bambu Studio command line to slice. Presets are read from your installation and flattened the way the app does. Details in docs/how-it-works.md.
In sync with the app.
open_in_bambu_studioshows a project in the app; if you change it there and save, the server re-reads it on the next command (and tells you if both sides changed).Safe with your files. Nothing is ever overwritten: saving adds
-2,-3... and opened files are read as a copy. Changing, renaming or deleting one of your presets keeps a backup copy first.Light. numpy, shapely, manifold3d, fonttools and Pillow. No Bambu profile is shipped with this repository: presets come from your installation (the server only carries default values for settings that presets leave out).
Your printer, your call. The LAN access code is read from Bambu Studio when needed and never copied anywhere. See SECURITY.md.
Guides
Calibrating a filament, step by step, with what to look at on each test print
Driving a closed slicer from an AI assistant: a technical write-up of the design and the tests
Limitations
Two-nozzle printers (H2D, H2C, X2D): filaments go to a nozzle automatically, as in Bambu Studio's default; choosing the nozzle of each filament by hand is not there yet.
The printer camera works with P1 and A1 printers (X1 and H2 stream over RTSP, not supported yet).
First-layer tests do not keep painted colors.
Bambu Studio re-slices a project when it opens it; to see a plate sliced and ready to print in the app, use
send_to_printer.
Roadmap
Mesh simplification and repair; the nozzle of each filament on two-nozzle printers; X1/H2 camera
A live bridge inside the slicer, to be proposed to OrcaSlicer and Bambu Studio
Contributing and support
Bug reports, ideas and pull requests: GitHub Issues. Include your OS, Bambu Studio version, printer and, if you can, the .3mf that fails. See CONTRIBUTING.md.
Author: Daniele Finocchiaro — danielefinocchiaro.com. If it saves you prints and time: buy me a coffee.
License
MIT for this code. Bambu Studio profiles are read from your installation and are not redistributed.
Available Tools
87 toolsadd_brim_earsA
Brim ears: small round brims only where a part needs them, instead of a brim all around (Bambu Studio's
Painted brim). Meant for print-in-place and articulated models: a full brim fills the joint gaps on the first
layer and welds them. Without points, ears go to the tips of the thin parts of the first layer (fingers, toes,
any tip thinner than narrow mm), each as large as possible up to radius without reaching another piece, a
gap or hole, or a second thin part (those tips are listed as skipped, with the reason). small > 0 also gives
ears to first-layer pieces smaller than that (mm²), at their ends. points: [[x, y], ...] or [[x, y, radius]]
in plate mm, placed as given, with a warning when one would weld something. radius 0 = Bambu Studio's default
(16 first-layer line widths across). keep: add to the ears the object already has.
Look at them with preview_plate(view='top', zoom=True), then slice_project and preview_layer(layer=1).
Inputs: object (required), keep, small, narrow, +3 more.
add_layer_actionA
Do something when the print reaches height z (mm), before that layer is printed:
action = pause (e.g. to insert magnets or nuts; message is shown in Bambu Studio),
filament_change (switch to filament slot filament from that height on, with the AMS),
gcode (any G-code line(s), e.g. 'M104 S210'). z is snapped to the nearest real layer at or above it.
Inputs: z (required), plate (required), action (required), gcode, +2 more.
add_modifierA
Add a part to an object, covering its whole footprint between z_from and z_to (mm from the object's bottom; z_to 0 = top), or only region [x0, y0, x1, y1] (mm from the object's center). kind: modifier (different settings inside, e.g. {"sparse_infill_density": "100%"} for the top 5 mm), negative (removes material), support_blocker, support_enforcer. shape: box, or cylinder (round, as wide as the smaller side of the region: e.g. a hole for a magnet or a screw is kind='negative', shape='cylinder', region=[-4, -4, 4, 4] for 8 mm).
Inputs: object (required), kind, z_to, shape, +3 more.
add_plateC
Add an empty plate at the end.
Inputs: name.
add_reliefA
Text or an SVG logo on a face of an object, raised or engraved, like Bambu Studio's Text and SVG tools. It wraps around curved faces: on a cup it keeps its size along the surface and stands out square to it. face: top, bottom, front, back, left, right (the side it is read from); at: [x, y, z] plate point to center it on (default: the middle of that face); size: capital letter height for text, longest side for an SVG (mm); depth: how far it stands out or goes in; rotate: degrees within the face. Raised, it is a new part (filament=N prints it in another color); engraved, a negative part (set_part_type turns it back). Look at preview_plate afterwards.
Inputs: object (required), at, svg, face, +7 more.
add_shapeA
Create a simple solid: box (width, depth, height), cylinder (diameter, height), cone (diameter,
diameter_top, height), sphere (diameter), text (text, text_height = capital letters in mm, height = depth
of the letters; base > 0 puts the text on a plate that thick, as a separate part 'Base' with filament
base_filament (0 = same as the text), e.g. white letters on a black tag; font = path to a .ttf/.otf),
svg (svg = path of an .svg file, a logo raised height mm; size = its longest side in mm, 0 = the file's
own size; base works as for text). To put text or a logo on an existing object, use add_relief.
Inputs: shape (required), x, y, svg, +14 more.
align_objectsA
Line up objects of one plate, like Bambu Studio's Align / Distribute, by their outer boxes. align: left, right, center_x (along X); front, back, center_y (along Y). distribute: 'x' or 'y' spaces them evenly between the two outermost ones. Both can be given.
Inputs: objects (required), align, distribute.
ams_loadA
Load the filament of an AMS slot into the nozzle, like Load in Bambu Studio's Device tab: the nozzle heats, the filament loaded now (if any) goes back to its slot, the new one comes in and is purged. slot: as in printer_status (AMS 1 = slots 1-4, AMS 2 = 5-8). Only when the printer is not printing. First call without confirm: nothing is sent, the answer says what would happen and the confirm code; tell the user, and only after they agree call again with confirm=. Bambu firmware accepts it only in LAN-only mode with Developer Mode; otherwise use the printer screen, Bambu Handy or Bambu Studio.
Inputs: slot (required), confirm.
ams_unloadA
Unload the filament in the nozzle back to its AMS slot, like Unload in Bambu Studio's Device tab (the nozzle heats). Only when the printer is not printing. First call without confirm: nothing is sent, the answer gives the confirm code; call again with confirm= only after the user agrees. Bambu firmware accepts it only in LAN-only mode with Developer Mode; otherwise use the printer screen, Bambu Handy or Bambu Studio.
Inputs: confirm.
arrangeA
Arrange objects by their real outline seen from above, brim and brim ears included, so shapes can nest
(like Bambu Studio's Arrange, which only uses convex hulls). gap: mm between those outlines (and from the
plate's edge half of it). Which objects: plate N, the named objects (ids or names), or all (plate=0).
plates: 0 = each object stays on its plate; N = spread them over plates 1..N, evenly; -1 = as few plates as
possible. rotate: allow turning them by multiples of rotation_step degrees (e.g. 60 for snowflakes);
multi_material false = one material (set of filaments) per plate; avoid_calibration_area: keep off the
printer's flow calibration corner (P1S/X1: front left); align_to_y: long side along Y first.
Plates with more than one material keep the back right corner free for the prime tower.
If something does not fit, nothing is moved: the answer says what is left over and how many plates it needs.
Objects not being arranged stay where they are. Look at preview_plate(view='top') afterwards.
Inputs: gap, plate, plates, rotate, +5 more.
bambu_statusB
Where Bambu Studio is installed, its version, whether it is running, and the current project.
Inputs: no named parameters.
boolean_objectsA
Mesh boolean between two objects where they are on the plate, like Bambu Studio's Mesh boolean.
difference: cut tool_object's shape out of object (a hole, a slot, a lettering); intersection: keep only what
they share; union: weld tool_object onto object (onto its part part, default the biggest). The result keeps
object's name, settings and filaments; painted colors stay, new faces take the part's filament. The tool object
is removed unless keep_tool=True. Both must be closed solids (check_object).
Inputs: object (required), tool_object (required), part, keep_tool, +1 more.
check_objectB
Is the mesh a closed, printable solid? Size, volume, number of separate pieces.
Inputs: object (required).
check_print_risksA
Before a long print: parts likely to come off or topple, and settings that do not fit. Per plate (0 = all): tall and narrow parts (height against the smaller side of the footprint), parts standing on a narrow or tiny footing without a brim (e.g. pins lying on their side), filaments whose temperature for this build plate is 0 (not meant for it), and plates where tall parts share a long print with many others (a part that fails late can knock the others: print them apart).
Inputs: plate.
convert_unitsB
An object modeled in other units, like Bambu Studio's Convert from inch / meter: unit 'inch', 'cm' or 'meter' scales it up from that unit to millimeters (a 1-unit cube becomes 25.4, 10 or 1000 mm); restore=True scales it back down. import_model says when a model looks like it is in inches or meters.
Inputs: object (required), unit, restore.
copy_object_settingsA
Copy one object's own settings (set_object_setting: infill, walls, brim...) to other objects, like Bambu Studio's Copy / Paste process settings. keys: only these; replace=True first removes the targets' own settings; height_ranges=True copies the height bands too.
Inputs: to_objects (required), from_object (required), keys, replace, +1 more.
cut_objectA
Cut an object with a plane, optionally with connectors that line the pieces up for gluing (like the
connectors of Bambu Studio's Cut tool). keep: both | bottom | top.
The plane is horizontal at height z (mm from the object's bottom), or goes through point [x, y, z] (plate mm,
z above the bed) with normal [nx, ny, nz]: [1, 0, 0] cuts vertically across x, [0.5, 0, 1] is tilted.
place: auto = the lower piece stays as it is and the upper one lies on its cut face; cut_down = both lie on their
cut faces; keep = both as they were.
connector: none | plug (a peg on the piece whose cut face is up, a hole with clearance mm per side in the
other) | dowel (holes in both pieces and a separate pin, added to the plate) | dovetail (a tongue across the
whole cut, along its length, and a slot in the other piece: they slide together from the side).
shape: cylinder | square | hexagon; style: prism | frustum (tapered, centers itself); size: diameter or side in
mm, or the dovetail's narrow width (0 = from the cut); depth: peg, pin or dovetail height (0 = automatic);
count: 0 = one per piece of the cut (two along a long one), N = spread over the cut; positions: [[x, y], ...] or
[[x, y, z]] in plate mm, taken on the plane (for a dovetail: a point on its middle line). Holes keep 2 mm of material from the
edge and get shallower where a piece is thin; connectors that do not fit are listed as skipped.
Modifiers, negative parts and painted colors are kept on the pieces.
Inputs: object (required), z, keep, size, +10 more.
delete_objectC
Remove an object from the project.
Inputs: object (required).
delete_presetB
Delete one of your user presets (a backup copy is kept, see the answer). A preset in your Bambu cloud cannot be deleted from here, because Bambu Studio would download it again at its next start: only its own Delete removes the cloud copy, and the answer says where it is.
Inputs: kind (required), name (required).
delete_printer_filesA
Free space on the printer's SD card: delete timelapse videos (with their thumbnails), files of past prints (kind='prints') or thumbnails whose video is gone (kind='thumbnails'). Pick them by names (from printer_files) or all those older than older_than_days. Two steps: without confirm nothing is deleted, the answer lists what would go, the space freed and a code; show the list to the user and only if they agree call again with confirm=. Deleted files cannot be recovered. Nothing is deleted while a print is running.
Inputs: kind (required), names, confirm, older_than_days.
download_printer_fileA
Copy a file from the printer's SD card into the projects folder: a timelapse video (name from printer_files, or 'latest') or the file of a past print (kind='prints'). For a timelapse its last frame is shown too: the finished print. Read-only on the printer.
Inputs: kind, name.
duplicate_objectB
Copy an object copies times onto free spots (same plate unless plate is given).
Inputs: object (required), plate, copies.
edit_presetA
Change settings of one of your user presets directly, without a project (a backup copy is kept). kind: filament | process | printer. values: {"key": "value"}, e.g. {"pressure_advance": "0.025", "enable_pressure_advance": "1"} or {"nozzle_temperature": "215"}; a list gives one value per extruder variant (Standard / High Flow nozzle); null removes the key, so the value comes from the parent preset again. Bambu system presets are read-only: save a user preset from them first. Bambu Studio sees the change after it restarts, and uploads it to your Bambu cloud if the preset is there.
Inputs: kind (required), name (required), values (required).
export_stlA
Save objects as STL files (e.g. to print them on other printers of a farm, or to share them): the named objects, all of a plate, or all of the project. One file per object, or one_file=True for all of them where they are on the plate. Negative parts (holes) are cut out; colors and settings are not part of an STL.
Inputs: plate, objects, one_file.
filament_colorsB
Official colors (name, hex) of a Bambu filament line, e.g. 'Bambu PLA Basic @BBL X1C'.
Inputs: preset (required).
fill_plateA
Fill the free area of an object's plate with copies of it, like Bambu Studio's Fill bed with copies. copies: 0 = as many as fit, N = at most N. Shapes nest by their real outline (brim and brim ears counted), and rotate=True also tries turning them by rotation_step degrees. The original is placed again together with the copies (more fit), unless keep_original=True; the other objects on the plate stay where they are.
Inputs: object (required), gap, copies, rotate, +2 more.
get_projectB
Current project: printer, process, filament slots, plates, objects (id, name, center, size, filaments), setting overrides and warnings. If the project was saved in Bambu Studio in the meantime it is re-read first.
Inputs: no named parameters.
get_purge_volumesB
Purge (flush) volumes between filament slots, in mm³, and the multiplier: the filament wasted at each change on the prime tower (or into infill/objects, see set_purge_volumes).
Inputs: no named parameters.
get_settingB
Current value of a print/filament/printer setting, where it comes from, and the preset value.
Inputs: key (required).
import_modelB
Put an STL, OBJ or 3MF on a plate. Without x/y it goes to the free spot closest to the center. From a 3MF every object is imported (with its parts and filament assignments).
Inputs: path (required), x, y, name, +4 more.
lay_flatB
Rotate an object so one of its flat faces lies on the bed: face 1 = the biggest flat face, 2 = the second biggest, and so on.
Inputs: object (required), face.
list_printersB
Printer short names that can be used anywhere a printer is asked (a full machine preset name works too).
Inputs: no named parameters.
list_user_presetsA
Your own Bambu Studio presets (kind: filament | process | printer; empty = all): the preset each one inherits and what it changes, whether it is in your Bambu cloud (then only Bambu Studio can delete or rename it), and which presets inherit it. To find system presets too, use search_presets.
Inputs: kind.
make_first_layer_testA
Add a plate with the first height mm of the objects of a plate (or of the listed objects):
a short print to check bed adhesion and the first layers before a long print. Slice it with
slice_project(plate=).
Inputs: plate, height, objects.
make_flow_testA
Add a plate of flow-rate squares for a filament slot, each printed with a different flow modifier (percent) engraved on top. Pass 1: -20..+20 step 5. Pass 2: around the best one, e.g. low=-4 high=4 step=1. Pick the square with the smoothest top surface (no gaps, no ridges).
Inputs: low, high, step, filament.
make_max_flow_testB
Max volumetric speed test for a filament slot, as a separate project file (the open project is not changed): single-wall cylinders, each printed at the wall speed that gives the volumetric speed Q (mm³/s) on its tag. Default range: around the filament's current limit. The highest Q without gaps or weak walls is the max; use a bit less (about 90%) as filament_max_volumetric_speed.
Inputs: low, high, step, filament.
make_pa_towerB
Add a plate with a pressure advance (flow dynamics) tower: a thin square tube printed fast, the K value grows
by step every millimeter. Find the height with the sharpest corners and no gaps: K = start + floor(height) * step.
When sending it, turn off the printer's automatic flow dynamics calibration.
Inputs: end, step, start, filament.
make_retraction_testA
Stringing test for a filament slot: one small separate project per retraction length (Bambu printers cannot change retraction during a print). Print them one after the other and keep the shortest length without strings between the two pillars; then set_setting('filament_retraction_length', value, slot) or save_filament_preset.
Inputs: lengths, filament.
make_temperature_towerB
Add a plate with a temperature tower for a filament slot: one 8 mm block per temperature (hottest at the bottom), each with a bridge and its temperature engraved on the front. Defaults: the filament's temperature +15 down to -25 °C, within its allowed range. Pick the block with the best bridge, surface and least stringing.
Inputs: end, step, start, filament.
make_vfa_testB
Add a plate with a VFA test (vertical fine artifacts: fine vertical ripples on walls that some speeds cause): one block per outer wall speed from start to end mm/s, the speed engraved on top. Look at the long faces with light from the side and pick the fastest speed without ripples for outer_wall_speed. Bambu Studio's VFA tower changes the speed inside one object; here each block has its own speed.
Inputs: end, step, start, filament.
measure_betweenA
Distance between two objects or two parts (part_a / part_b; the same object twice with two parts measures the clearance between them), in plate mm: the smallest gap with about where it is, the distance between their centers, the gap along each axis between their outer boxes (negative = they overlap along it) and, if they overlap, the volume they share.
Inputs: object_a (required), object_b (required), part_a, part_b.
measure_objectA
Measure an object (or its part part), in plate mm: size and where it is, each part's size, volume and
surface, the area standing on the bed, the smallest gaps between its separate pieces or parts (the clearance of
print-in-place joints, with where), and walls thinner than the nozzle's line width (or min_wall mm), with
where and at which heights. z >= 0: also the cross-section at that height above the bed, every island with
its length, width and thickest point and its holes (how long and thick a bar is, how wide a hole is).
Inputs: object (required), z, part, min_wall.
merge_objectsA
Join objects of the same plate into one object with several parts, where they are now, like Bambu Studio's Assemble: they move and print as one (e.g. a model and its base in another color). Each part keeps its filament and painting; the merged object takes the first object's settings (the others' are listed if they differ).
Inputs: objects (required), name.
mirror_objectC
Mirror an object across its own center (axis x, y or z).
Inputs: object (required), axis.
move_objectA
Move an object (by name or id): absolute x/y, relative dx/dy, rotate around Z by rotate_z degrees, or move it to another plate (it keeps x/y if given, otherwise it goes to a free spot).
Inputs: object (required), x, y, dx, +3 more.
new_projectB
Start an empty project. filaments: AMS slots in order, e.g. [{"preset": "Bambu PLA Basic", "color": "#000000"}, {"preset": "eSUN PLA+", "color": "#FFFFFF"}]. A filament name without '@...' is matched to the printer automatically. The build plate type is the one picked in Bambu Studio for this printer (change it with set_setting('curr_bed_type', ...)).
Inputs: name (required), printer, process, filaments.
open_in_bambu_studioA
Open a .3mf in the Bambu Studio window: by default the last saved project (else the last sliced one). Bambu Studio re-slices a project when asked (Slice plate), it does not reuse the slicing done here; to open a plate sliced and ready to print, use send_to_printer(via='bambu_studio').
Inputs: path.
open_projectA
Open a .3mf saved by Bambu Studio (or downloaded from MakerWorld). The file is never modified: save_project writes a new file. Returns the project summary and what could not be carried over.
Inputs: path (required).
orient_objectA
Turn an object the way up it prints best, like Bambu Studio's Auto orientation: least area that needs support (faces leaning more than overhang_angle degrees from vertical, not on the bed), enough area on the bed, low height. Returns the 3 best options with those numbers and the current ones; choice=2 or 3 applies another option, apply=False only compares. Look at preview_plate afterwards.
Inputs: object (required), apply, choice, overhang_angle.
paint_objectA
Paint a region of an object, like Bambu Studio's painting tools. paint: 'color' (with filament=N),
'support' (supports there), 'block_support' (none there), 'seam' (put the seam there), 'block_seam',
'fuzzy_skin'. Region: the height band z_from..z_to (mm from the object's bottom; z_to=0 = to the top) and the
faces looking 'top', 'bottom', 'sides', 'front', 'back', 'left', 'right', 'overhangs' (leaning more than angle
degrees from vertical, for supports) or 'all'. clear=True removes that painting there. Triangles crossing a
band's edge are split, so the edge is sharp. part: only that part. Look at preview_plate (colors) afterwards.
Inputs: paint (required), object (required), part, z_to, +5 more.
preview_layerA
Image of one sliced layer seen from the top (needs slice_project first). Choose by layer number (1 = first) or by height z in mm. Extrusions are drawn in the filament colors. zoom: frame the extrusions (default), or False for the whole bed.
Inputs: z, zoom, layer, plate.
preview_plateA
Image of a plate with its objects in their filament colors (painted colors too). view: iso | top. zoom: frame the objects instead of the whole bed, to see details. labels: write each object's id and name on it, e.g. view='top', labels=True to tell which part is which (a part that came off the plate, the list in Bambu Handy's skip objects).
Inputs: view, zoom, plate, labels.
printer_cameraA
A picture from the printer's camera right now (P1 and A1 series), to see the plate: how a print is going, whether something came off or made spaghetti, what is left on the bed. Read-only; works with the printer in cloud mode. With the chamber light off the picture is dark. max_size: longest side in pixels.
Inputs: max_size.
printer_filesA
Files on the printer's SD card, newest first, with name, size and date and the total per folder: timelapse (videos of past prints), prints (files of past prints the printer keeps), thumbnails (timelapse thumbnails whose video was deleted). Read-only; works with the printer in cloud mode.
Inputs: kind, limit.
printer_statusA
Read-only status of the printer on the local network: state, job, progress, remaining time, layer (or the last job's result when idle), temperatures, AMS trays (type, color, remaining %; 'unknown' = a spool the AMS has not been told about), AMS humidity and temperature, active slot, errors, objects skipped during the print, and warnings (the spool being fed is unknown or not the project's filament, sport speed on a long print, a report that looks old). read_at = when the printer sent it; age_s = seconds since, when a reading of a few seconds ago is given again (the printer is asked at most every 20 s). Works with the printer in normal cloud mode (Bambu Handy keeps working). Nothing is sent to the printer except a status request.
Inputs: no named parameters.
remove_brim_earsC
Remove an object's brim ears; its brim goes back to the project's brim type.
Inputs: object (required).
remove_height_rangeB
Remove the height band of an object that starts at z_from (mm), or all its bands (z_from=-1).
Inputs: object (required), z_from.
remove_layer_actionB
Remove a layer action (1-based index as listed by get_project), or all of them with index 0.
Inputs: plate (required), index.
remove_partA
Remove a part (e.g. a modifier) from an object, by part name. The last solid part cannot be removed.
Inputs: part (required), object (required).
remove_plateA
Delete a plate. Its objects are moved to plate move_objects_to (0 = delete them too).
Inputs: plate (required), move_objects_to.
rename_plateC
Give a plate a name (shown in Bambu Studio).
Inputs: name (required), plate (required).
rename_presetB
Rename one of your user presets (a backup copy is kept). A preset in your Bambu cloud cannot be renamed from here, because Bambu Studio would download the old one again: the answer says how to do it in Bambu Studio.
Inputs: kind (required), name (required), new_name (required).
replace_with_stlA
Swap the shape of an object (or of its part part) for the one in an STL/OBJ/3MF file, like Bambu
Studio's Replace with STL, e.g. after fixing it in CAD. Name, filament, settings, place on the plate and the
other parts stay; the new shape takes the old one's center, standing on the same bottom. Painting on the old
shape is dropped (it was for other triangles).
Inputs: path (required), object (required), part.
reprint_objectsA
A new project with only some objects of the open one, e.g. a part that came off the plate and was skipped: same printer, process, filaments and settings, laid out again (more plates if needed); brim=True gives each an outer brim. Saved as a new file (never overwrites) and sliced; the open project is not changed: open_project(file) then send_to_printer to print it. objects: names or ids (see get_project).
Inputs: objects (required), brim, name, slice.
reset_settingB
Drop an override: the setting goes back to the preset value.
Inputs: key (required).
save_filament_presetA
Save the filament of a slot, with this project's changes for that slot (temperatures, flow ratio, pressure advance, plate temperatures...), as a Bambu Studio user preset; it appears after Bambu Studio restarts. A new filament (made from a Generic preset, or with another filament_vendor) is saved like Bambu Studio's Create Filament does: its own filament id, so it can be picked for an AMS slot (Device > AMS). Changes to a Bambu filament are saved as a variant of it, so its RFID spools still match it. replace=True updates an existing user preset with that name (e.g. after a calibration): it keeps its filament id, so AMS slots set to it stay valid, and a backup copy is kept. Never overwrites otherwise.
Inputs: name (required), slot (required), replace.
save_printer_presetA
Save this project's printer changes (start/end G-code, retraction, printable area...: the set_setting changes that belong to the printer) as a Bambu Studio user printer preset, a child of the project's printer preset. replace=True updates your user preset with that name (a backup copy is kept). It appears after Bambu Studio restarts.
Inputs: name (required), replace.
save_process_presetA
Save this project's process changes (layer height, walls, infill, speeds, brim, supports, ironing...: the set_setting changes that belong to the process) as a Bambu Studio user process preset, a child of the project's process preset, like Save as in Bambu Studio. replace=True updates your user preset with that name (a backup copy is kept). It appears after Bambu Studio restarts.
Inputs: name (required), replace.
save_projectA
Write the project as a Bambu Studio .3mf (default folder: the output dir, name from the project). Never overwrites: if the file exists a -2, -3... suffix is added. Optionally open it in Bambu Studio.
Inputs: path, open_in_bambu.
search_presetsA
Find presets. kind: filament | process | machine. query: words to match (e.g. 'eSUN PLA+', '0.16mm'). With printer, only presets compatible with it. User presets come first.
Inputs: kind (required), limit, query, printer.
send_to_printerA
Make the print file of one plate (.gcode.3mf) and send it. via = auto (Bambu Connect if installed, otherwise Bambu Studio) | bambu_connect | bambu_studio: open it in an official Bambu app, where the user checks printer and AMS mapping and presses Print/Send. via = file: only make the file. via = lan: copy it to the printer on the local network and START PRINTING, for printers in LAN-only mode with Developer Mode (print farms; in cloud mode the printer refuses and the answer says so). Two steps: without confirm nothing is sent, the answer gives the AMS slots it would use and a code; check with the user that the plate is clear, then call again with confirm=. AMS slots: from use_ams_filaments, or ams_slots (one AMS slot per project filament slot, 0 = automatic), or the tray with the same type and the closest color. Tell the user the time, weight and filaments of the plate (and for lan, follow it with printer_status).
Inputs: via, plate, confirm, ams_slots, +2 more.
set_filamentA
Change one filament slot (1-based); a new slot number = add a slot. Leave a field empty to keep it.
Inputs: slot (required), color, preset.
set_height_rangeA
Settings for a height band of an object, like Bambu Studio's Height range modifier. Heights are mm from the object's bottom. E.g. z_from=0, z_to=5, settings={"sparse_infill_density": "100%"}; {"layer_height": "0.12"} for finer layers there (variable layer height); {"filament": 2} to print that band with another filament slot (a color band). A band with the same z_from and z_to is updated (null removes a key); bands cannot overlap.
Inputs: z_to (required), object (required), z_from (required), settings (required).
set_object_filamentB
Assign a filament slot to a whole object, or to one of its parts (by part name).
Inputs: object (required), filament (required), part.
set_object_printableA
Keep an object on the plate but leave it out of the print (printable=False), like unticking Printable in Bambu Studio; True puts it back. The other objects slice and print as usual.
Inputs: object (required), printable.
set_object_settingB
Per-object print setting (e.g. sparse_infill_density '40%', wall_loops '4', layer_height '0.12'). An empty value removes the override.
Inputs: key (required), value (required), object (required).
set_part_typeB
Change what a part of an object is, like Bambu Studio's Change type: 'part' (printed), 'modifier' (its settings apply inside it), 'negative' (cut out, a hole), 'support_blocker' or 'support_enforcer'. An object keeps at least one printed part.
Inputs: part (required), type (required), object (required).
set_plate_settingsA
Settings of one plate, like Bambu Studio's plate settings; they win over the project's on that plate. bed_type: Cool Plate, Engineering Plate, High Temp Plate, Textured PEI Plate or Supertack Plate. print_sequence: 'by layer', or 'by object' (each object printed to the end before the next). first_layer_filaments: order of the filament slots on the first layer, e.g. [2, 1]. spiral_vase: 'on' or 'off'. prime_tower: [x, y] in mm, where its corner goes (e.g. between objects). 'global' (or [] for the lists) goes back to the project's choice; empty leaves it as it is.
Inputs: plate (required), bed_type, prime_tower, spiral_vase, +2 more.
set_printerB
Switch printer (e.g. P1S -> A1M). Filament presets are swapped for the same filaments on the new printer. With rearrange, objects are re-placed to fit the new bed (extra plates are added if needed).
Inputs: printer (required), process, rearrange.
set_purge_volumesA
Change the purge (flush) volumes, as in Bambu Studio's Purging volumes dialog. volumes: [{"from": 1, "to": 2, "volume": 350}, ...] mm³ for single changes; matrix: every value at once, rows = from, columns = to (the diagonal is ignored); multiplier: scales all of them (0..3, 1 = as written); reset: back to the values estimated from the colors and multiplier 1. A value set by hand stays while both slots keep their color. Values are 0..900 mm³. Less purge saves filament but the new color can come out mixed at first; to waste less without that, purge into the infill or into an object with set_setting('flush_into_infill', '1') or set_object_setting(object, 'flush_into_objects', '1').
Inputs: reset, matrix, volumes, multiplier.
set_settingA
Override a project setting. For filament settings (temperatures, plate temperatures...) slot = filament slot (0 = all slots). Values are Bambu Studio strings, e.g. '0.16', '15%', '65'. Useful keys: layer_height, wall_loops, sparse_infill_density, top_shell_layers, enable_support, brim_type, initial_layer_speed, ironing_type, textured_plate_temp(_initial_layer) for Textured PEI, hot_plate_temp(_initial_layer) for the smooth/High Temp plate, nozzle_temperature(_initial_layer), close_fan_the_first_x_layers, print_sequence ('by object'), curr_bed_type ('Textured PEI Plate').
Inputs: key (required), value (required), slot.
skip_objectsA
Stop printing some objects of the print running now, e.g. a part that came off the plate. It CANNOT be undone. ids: the objects' ids as the printer knows them (identify_id; Bambu Handy's skip list, or printer_status 'skipped_objects'). Do not list every object: to stop the whole print, cancel it on the printer. First call without confirm: nothing is sent, the answer says what would be skipped and the confirm code; tell the user, and only after they agree call again with confirm=. Bambu firmware accepts it only in LAN-only mode with Developer Mode; otherwise use Bambu Handy or the printer.
Inputs: ids (required), confirm.
slice_projectA
Slice with Bambu Studio (plate 0 = all). Returns per plate: minutes, grams (total and per filament slot), cost (from the presets' price per kg), filament changes, layers and warnings. The sliced project is saved next to the project file.
Inputs: plate.
split_objectA
Split an object into its separate pieces, like Bambu Studio's Split: into='objects' makes one object per piece (each part of a multi-part object becomes an object too), into='parts' keeps one object whose parts are the pieces, so each can get its own filament. Pieces stay where they are; painted colors are kept, modifiers and negative parts go with the piece they overlap.
Inputs: object (required), into.
sync_with_bambu_studioA
Re-read the project file after you changed it by hand in Bambu Studio and saved (same file). This also happens automatically on the next command when there are no unsaved changes here; force=True takes the app's version even if there are (they are lost).
Inputs: force.
transform_objectB
Scale (uniform or per axis) and rotate an object around its center. It stays on the bed.
Inputs: object (required), scale, rotate_x, rotate_y, +2 more.
use_ams_filamentsA
Set the project's filament slots from what is loaded in the AMS right now (preset and color), like Bambu Studio's 'sync AMS'. Default: every loaded tray in order (project slot 1 = first loaded tray). ams_slots: pick trays explicitly, e.g. [1, 3] -> project slot 1 = AMS slot 1, project slot 2 = AMS slot 3.
Inputs: ams_slots.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 87 tools
The tool set is broad, but most tools target a clearly different resource or action, and descriptions explicitly distinguish adjacent operations. Some clusters still require care, such as add_shape/add_relief/add_modifier, set_setting/set_object_setting/set_plate_settings, and the several preset and calibration-test tools.
Most names follow a snake_case verb_noun pattern such as open_project, set_filament, add_plate, and preview_plate. There are minor deviations with noun-style read tools like printer_status and filament_colors, plus a bare verb like arrange, but the convention remains readable and predictable.
Eighty-seven tools is far beyond a well-scoped set and bundles project editing, object modeling, slicing, calibration tests, preset management, printer control, AMS handling, and SD-card file management into one server. Even for this broad domain, the surface is extreme and will impose high selection and context costs.
Coverage is unusually comprehensive: project lifecycle, plates, objects, parts, settings, presets, slicing, previews, sending, AMS, printer status, camera, printer files, and many calibration workflows are all represented. Only specialized print-job controls such as pause/resume or cancel are not directly present, which is minor relative to the overall surface.
Maintenance
Related MCP Connectors
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
6 3D/CAD MCP tools: STL repair, OBJ/GLB/SVG conversion, slicing, G-code M600, SVG optimize.
Free 3D conversion (FBX, GLB, OBJ, STL, PLY, DAE, USDZ, 3MF) as a remote MCP server. No account.
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Bambu Lab-focused MCP server for controlling Bambu printers, manipulating STL files, and managing end-to-end 3MF print workflows from any MCP-compatible client.3755 npmGPL 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for pre-print QA of Bambu Studio projects, providing tools to inspect models and 3MF files, validate risky settings, create support variants, and open files in Bambu Studio.MIT
- AlicenseNot gradedqualityBmaintenanceEnables secure local control of Anycubic Slicer Next and compatible printers, supporting slicing, 3MF/CAD operations, printer control, spool registry, and camera access through MCP tools.1MIT
- AlicenseBqualityBmaintenanceMCP server for BambuStudio slicer: inspect geometry, configure saved projects, and compare slices with Claude Code or Codex.292AGPL 3.0