Skip to main content
Glama
unofficial-bambu-mcp

unofficial-bambu-mcp

unofficial-bambu-mcp

ci pypi python license

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 session: a project from scratch, a print risk fixed, slicing, a temperature tower, the print file

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. use_ams_filaments takes what is loaded in the AMS right now.

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

arrange by the real outline seen from above, brim and brim ears included, so shapes nest (Bambu Studio's own arrange uses convex hulls). Gap, rotation steps, one material per plate, calibration corner, align to Y, prime tower corner kept free; one plate, chosen objects or all; "put them in N plates" evenly or as few as possible, and if they do not fit nothing moves and it says what is left over.

Cutting

cut_object on any plane, with connectors like Bambu Studio's Cut tool: a plug (peg and hole with clearance), dowels (holes in both pieces and separate pins) or a dovetail; round, square or hexagonal, straight or tapered, placed automatically or where you say, made shallower where a piece is thin. The pieces are laid out to print: the peg always points up.

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 (save_filament_preset), process and printer; or change one of your presets directly (edit_preset), list, rename and delete them, with a backup copy each time. Values are checked and written the way Bambu Studio does (one per nozzle variant where it applies), and changes are stamped for Bambu Studio's cloud sync. Presets that are in your Bambu cloud can only be deleted from Bambu Studio: the answer says how.

Text & logos

add_relief: text or an SVG logo on any face of an object, raised (in another color if you like) or engraved, following curved surfaces too (the surface under it is measured on a fine grid and the shape is wrapped on it, keeping its size along the surface). add_shape('svg'): a logo as an object, on a base in another color. SVG paths, shapes, transforms, fill rules and strokes are read.

Measuring

measure_object: size and place, each part's volume and surface, the area on the bed, the clearance between the pieces of a print-in-place model, walls thinner than the nozzle line (where and at which height), and the cross-section at any height: how long and thick a bar is, how wide a hole is. measure_between: the gap between two objects or parts, centers, overlap. Dense meshes are measured on a copy within 0.005 mm (2.4 M triangles in about 9 s).

Height ranges & plates

set_height_range: settings for a band of an object's height, like Bambu Studio's Height range modifier: 100 % infill at the bottom, finer layers where the details are (variable layer height), another filament for a band (color by height). Variable layer heights and ranges in opened files are kept. set_plate_settings: build plate, print sequence (by object), first-layer filament order, spiral vase and prime tower place per plate.

Painting

paint_object: colors, supports (or no supports), seams and fuzzy skin on a height band and/or the faces looking one way (top, sides, overhangs...), with sharp edges. Checked on the sliced G-code: a color band changes filament at its edges, painted supports appear where painted.

Purge volumes

get_purge_volumes / set_purge_volumes: the purge between each pair of slots and the multiplier, as in Bambu Studio's dialog; the values in opened files are kept.

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

check_print_risks: tall and narrow parts, parts standing on a tiny or narrow footing without a brim, filaments not meant for the build plate, tall parts sharing a long plate, a full brim on a print-in-place model whose joints it would weld.

Brim ears

add_brim_ears: small round brims only on the thin tips (fingers, toes) of print-in-place and articulated models, placed automatically away from joint gaps and other pieces, or where you say. Bambu Studio's Painted brim, checked on the sliced first layer.

Reprints

reprint_objects: a new project with only the parts that failed, same settings, with a brim.

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

send_to_printer makes the print file of a plate and opens it in Bambu Studio (or Bambu Connect) ready to print: you check the AMS mapping and press Print.

Developer Mode (LAN farms)

For printers in LAN-only mode with Developer Mode, where Bambu firmware accepts commands from other programs: send_to_printer(via='lan') uploads the plate and starts the print, skip_objects skips parts of the running print, ams_load / ams_unload move filament. Each asks first: the first call sends nothing and gives a code to confirm with. In normal cloud mode the printer refuses them and the answer says so.

Printer status

printer_status (read only, local network): state, progress, temperatures, AMS trays with humidity, skipped objects, and warnings (unknown spool being fed, sport speed on a long print, a reading that looks old).

Camera & SD card

printer_camera: a picture of the plate right now, so the assistant sees how the print is going. printer_files / download_printer_file: timelapses (with their last frame) and past print files. delete_printer_files: free space on the SD card, only after you confirm the exact list. Works in cloud mode.

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-mcp

Claude 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 uvx prints it.

  • uvx keeps the version it downloaded: write unofficial-bambu-mcp@latest instead 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

UBMCP_DIR

~/Documents/unofficial-bambu-mcp

Where projects, sliced files and print files are saved

BAMBU_STUDIO_EXE

auto-detected

Path of the Bambu Studio executable

BAMBU_STUDIO_DATA

auto-detected

Bambu Studio data folder (with system/ and user/)

BAMBU_STUDIO_RESOURCES

auto-detected

Bambu Studio resources folder (with profiles/), for unusual Linux installs

UBMCP_PRESET_BACKUPS

~/.config/unofficial-bambu-mcp/preset-backups

Where a copy of a user preset goes before it is changed, renamed or deleted

BAMBU_PRINTER_SERIAL, BAMBU_PRINTER_ACCESS_CODE, BAMBU_PRINTER_IP

from Bambu Studio

Printer for printer_status, if you do not want it read from Bambu Studio

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_studio shows 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

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 tools
add_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

    B3.3/5.0

    Scored across 87 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      37
      55 npm
      GPL 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • A
      license
      B
      quality
      B
      maintenance
      MCP server for BambuStudio slicer: inspect geometry, configure saved projects, and compare slices with Claude Code or Codex.
      29
      2
      AGPL 3.0