MCP Tools
bambu-mcp registers 104 tools. Each carries MCP annotations: a title and a read-only flag, plus destructive, idempotent and open-world hints.
50 of the 53 write tools refuse to act unless called with user_permission=True. Without it they change nothing and return a refusal naming the consequence. The rest need no permission because they change only the local server, not the printer: set_user_pref, start_stream, stop_stream. Tools that disturb a print also refuse while the printer is printing, whatever user_permission says.
Parameters, return shapes and notes below come from the tool docstrings the server sends to MCP clients.
By category
| Category | Tools | Write tools |
|---|---|---|
| Printer State | 11 | 0 |
| Print Control | 9 | 9 |
| Climate | 7 | 5 |
| Filament & AMS | 11 | 8 |
| Nozzles | 4 | 3 |
| Detectors | 7 | 6 |
| Printer Management | 7 | 5 |
| Files | 19 | 6 |
| System | 13 | 8 |
| Discovery | 1 | 0 |
| Raw Commands | 1 | 1 |
| Camera | 6 | 2 |
| Alerts | 1 | 0 |
| Snapshots & Monitoring Data | 4 | 0 |
| Charts | 3 | 0 |
All tools
| Tool | Title | Category | Access |
|---|---|---|---|
add_printer |
Add Printer | Printer Management | write, destructive |
analyze_active_job |
Analyze Active Print Job | Camera | read-only |
calibrate_ams_remaining |
Rescan AMS Spool RFID | Filament & AMS | write |
clear_print_error |
Clear Print Error | Print Control | write |
create_folder |
Create SD Card Folder | Files | write |
delete_file |
Delete SD Card File | Files | write, destructive |
disconnect_printer |
Disconnect Printer | Printer Management | write |
discover_printers |
Discover LAN Printers | Discovery | read-only |
download_file |
Download SD Card File | Files | write, destructive |
dump_log |
Read Server Log | System | read-only |
force_state_refresh |
Force Printer State Refresh | System | write |
get_3mf_entry_by_id |
Find 3MF Entry By Path | Files | read-only |
get_3mf_entry_by_name |
Find 3MF Entry By Name | Files | read-only |
get_all_project_info |
Get All Plate Info | Files | read-only |
get_ams_status |
Get AMS Status | Printer State | read-only |
get_ams_units |
Get AMS Units | Filament & AMS | read-only |
get_capabilities |
Get Printer Capabilities | Printer State | read-only |
get_chamber_light |
Get Chamber Light State | Climate | read-only |
get_climate |
Get Climate Status | Climate | read-only |
get_configured_printers |
List Configured Printers | Printer Management | read-only |
get_current_job_project_info |
Get Current Job Project Info | Files | read-only |
get_detector_settings |
Get Detector Settings | Detectors | read-only |
get_external_spool |
Get External Spool | Filament & AMS | read-only |
get_fan_speeds |
Get Fan Speeds | Printer State | read-only |
get_filament_catalog |
Get Filament Catalog | Filament & AMS | read-only |
get_file_info |
Get SD Card File Info | Files | read-only |
get_firmware_version |
Get Firmware Version | System | read-only |
get_hms_errors |
Get HMS Errors | Printer State | read-only |
get_job_info |
Get Print Job Info | Printer State | read-only |
get_monitoring_data |
Get Monitoring Data URL | Snapshots & Monitoring Data | read-only |
get_monitoring_history |
Get Monitoring History URL | Snapshots & Monitoring Data | read-only |
get_monitoring_series |
Get Monitoring Series URL | Snapshots & Monitoring Data | read-only |
get_nozzle_info |
Get Nozzle Info | Nozzles | read-only |
get_pending_alerts |
Get Pending Alerts | Alerts | read-only |
get_plate_thumbnail |
Get Plate Thumbnail | Files | read-only |
get_plate_topview |
Get Plate Top View | Files | read-only |
get_print_progress |
Get Print Progress | Printer State | read-only |
get_printer_connection_status |
Get Printer Connection Status | Printer Management | read-only |
get_printer_info |
Get Printer Info | Printer State | read-only |
get_printer_state |
Get Printer State | Printer State | read-only |
get_project_info |
Get Project Plate Info | Files | read-only |
get_server_info |
Get Server Port Info | System | read-only |
get_session_status |
Get MQTT Session Status | System | read-only |
get_snapshot |
Get Camera Snapshot URL | Snapshots & Monitoring Data | read-only |
get_spool_info |
Get Spool Info | Printer State | read-only |
get_stream_url |
Get Camera Stream Info | Camera | read-only |
get_temperatures |
Get Temperatures | Printer State | read-only |
get_user_pref |
Get Sticky Preference | System | read-only |
get_wifi_signal |
Get Wi-Fi Signal | Printer State | read-only |
list_sdcard_files |
List SD Card Files | Files | read-only |
load_filament |
Load Filament | Filament & AMS | write |
open_charts |
Open Telemetry Dashboard | Charts | read-only |
open_job_state |
Open Job State Images | Camera | read-only |
open_plate_layout |
Open Plate Layout Image | Files | read-only |
open_plate_viewer |
Open Plate Viewer | Files | read-only |
pause_mqtt_session |
Pause MQTT Session | System | write |
pause_print |
Pause Print | Print Control | write |
preview_ams_mapping |
Preview AMS Mapping | Files | read-only |
print_file |
Start Print From SD Card | Files | write, destructive |
refresh_nozzles |
Refresh Nozzle Info | Nozzles | write |
refresh_sdcard |
Refresh SD Card Listing | Files | read-only |
remove_printer |
Remove Printer | Printer Management | write, destructive |
rename_printer |
Rename Printer Device | System | write |
rename_sdcard_file |
Rename SD Card File | Files | write |
render_charts_html |
Render Dashboard HTML | Charts | read-only |
render_charts_panels |
Render Dashboard Panels | Charts | read-only |
resume_mqtt_session |
Resume MQTT Session | System | write |
resume_print |
Resume Print | Print Control | write |
select_extrusion_calibration |
Select Extrusion Calibration | Print Control | write |
send_ams_control_command |
Send AMS Control Command | Filament & AMS | write |
send_gcode |
Send G-code | Print Control | write, destructive |
send_mqtt_command |
Send Raw MQTT Command | Raw Commands | write, destructive |
set_air_printing_detection |
Set Air Printing Detection | Detectors | write |
set_ams_filament_setting |
Set AMS Filament Setting | Filament & AMS | write |
set_ams_user_setting |
Set AMS User Setting | Filament & AMS | write |
set_bed_temp |
Set Bed Temperature | Climate | write |
set_buildplate_marker_detection |
Set Buildplate Marker Detection | Detectors | write |
set_chamber_light |
Set Chamber Light | Climate | write |
set_chamber_temp |
Set Chamber Temperature | Climate | write |
set_fan_speed |
Set Fan Speed | Climate | write |
set_first_layer_inspection |
Set First Layer Inspection | Detectors | write |
set_nozzle_clumping_detection |
Set Nozzle Clumping Detection | Detectors | write |
set_nozzle_config |
Set Nozzle Config | Nozzles | write |
set_nozzle_temp |
Set Nozzle Temperature | Climate | write |
set_print_option |
Set Print Option | Print Control | write |
set_print_options |
Set Print Options | System | write |
set_print_speed |
Set Print Speed | Print Control | write |
set_purge_chute_detection |
Set Purge Chute Detection | Detectors | write |
set_spaghetti_detection |
Set Spaghetti Detection | Detectors | write |
set_user_pref |
Set Sticky Preference | System | write |
skip_objects |
Skip Print Objects | Print Control | write, destructive |
start_ams_dryer |
Start AMS Dryer | Filament & AMS | write |
start_printer |
Start Printer Session | Printer Management | write |
start_stream |
Start Camera Stream | Camera | write |
stop_ams_dryer |
Stop AMS Dryer | Filament & AMS | write |
stop_print |
Stop Print | Print Control | write, destructive |
stop_stream |
Stop Camera Stream | Camera | write |
swap_tool |
Swap Active Extruder | Nozzles | write |
trigger_printer_refresh |
Trigger Printer Refresh | System | write |
truncate_log |
Truncate Server Log | System | write, destructive |
unload_filament |
Unload Filament | Filament & AMS | write |
update_printer_credentials |
Update Printer Credentials | Printer Management | write, destructive |
upload_file |
Upload File To SD Card | Files | write, destructive |
view_stream |
View Camera Stream | Camera | read-only |