print_3mf
Print a 3MF file on a Bambu Lab printer. Auto-slices if the file contains no G-code. Specify the printer model to ensure safe operation.
Instructions
Print a 3MF file on a Bambu Lab printer. Auto-slices if the 3MF has no gcode. IMPORTANT: bambu_model must be specified to ensure safe printer operation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Hostname or IP of the printer (default: value from env) | |
| dev_id | No | Bambu device id for FULU BambuNetwork printing; defaults to BAMBU_DEV_ID or BAMBU_SERIAL. | |
| dev_ip | No | Printer IP address for FULU BambuNetwork LAN/local print methods; defaults to host when provided. | |
| printer | No | Configured printer ID. Omit to use the default printer or the only configured printer. | |
| use_ams | No | Whether to use the AMS (default: auto-detect from 3MF) | |
| bed_type | No | Bed plate type currently installed (default: textured_plate) | |
| ams_slots | No | Preferred AMS input: one absolute tray index per USED filament in plate order, e.g. [1] for a single-filament print pulling from AMS 0 slot 1. Expanded to project-level ams_mapping automatically from the 3MF's plate_N.json and gcode header. | |
| timelapse | No | Enable timelapse recording (default: false) | |
| user_info | No | Optional BambuNetwork user_info JSON string passed to net.change_user for the FULU bridge. | |
| ams_mapping | No | Project-level AMS mapping array. Position = project filament index, value = absolute AMS tray (0-3=AMS 0, 4-7=AMS 1, 8-11=AMS 2, 128+=AMS-HT, 254=external, -1=unused). Prefer ams_slots unless you know the project-level layout. | |
| bambu_model | No | REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer. | |
| bambu_token | No | Access token (default: value from env) | |
| plate_index | No | Zero-based plate index to print from the sliced 3MF (default: 0) | |
| slicer_path | No | Path to the slicer executable for auto-slicing (default: value from env or a platform default) | |
| slicer_type | No | Slicer to use only if auto-slicing an unsliced 3MF. Bambu-compatible slicer aliases such as fulu-orca and orca-studio are accepted. | |
| bambu_serial | No | Serial number (default: value from env) | |
| bed_leveling | No | Enable auto bed leveling (default: true) | |
| country_code | No | BambuNetwork country code, such as US, used by the FULU bridge agent. | |
| template_dir | No | Optional template directory override when resolving template_name. | |
| template_name | No | Optional named template from the local registry. Resolves to template_3mf_path automatically. | |
| three_mf_path | Yes | Path to the 3MF file to print | |
| auto_match_ams | No | When true, match the sliced 3MF's tray_info_idx requirements against live AMS inventory and use the resulting ams_slots. Ignored when ams_mapping or ams_slots is provided. | |
| bridge_command | No | Override command for the FULU bridge host or macOS/WSL wrapper; defaults to BAMBU_NETWORK_BRIDGE_COMMAND. | |
| slicer_profile | No | Path to the slicer profile/config file for auto-slicing (optional). | |
| connection_mode | No | Print path to use: lan_mqtt_ftps uses this MCP's direct local MQTT/FTPS path; bambu_network uses the restored FULU BambuNetwork bridge. | |
| connection_type | No | BambuNetwork connection type when connection_mode is bambu_network; cloud uses restored internet printing, lan uses local bridge printing. | |
| nozzle_diameter | No | Nozzle diameter in mm for auto-slicing (default: 0.4) | |
| flow_calibration | No | Enable flow calibration (default: true) | |
| template_3mf_path | No | Optional template 3MF whose embedded Bambu slicer settings should be reused when auto-slicing this print job. | |
| bambu_network_method | No | FULU print method when connection_mode is bambu_network; defaults to start_print for cloud and start_local_print for lan. | |
| vibration_calibration | No | Enable vibration calibration (default: true) | |
| bambu_network_config_dir | No | Config/log directory used by the FULU BambuNetwork agent. |