Skip to main content
Glama

print_3mf_bambu_network

Destructive

Print 3MF files via FULU OrcaSlicer-bambulab's restored BambuNetwork path instead of MCP LAN MQTT/FTPS, supporting cloud or LAN jobs.

Instructions

Print a 3MF through FULU OrcaSlicer-bambulab's restored BambuNetwork path instead of the MCP LAN MQTT/FTPS path.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "three_mf_path": "<three_mf_path>",
      "bambu_model": "<bambu_model>"
    },
    "name": "print_3mf_bambu_network"
  }
}

Input Schema

NameRequiredDescriptionDefault
hostNoPrinter host or IP address, used as dev_ip for LAN/local bridge methods.
dev_idNoBambu device id used by BambuNetwork; defaults to BAMBU_DEV_ID or BAMBU_SERIAL.
dev_ipNoPrinter IP address for LAN/local bridge methods; defaults to host when provided.
use_amsNoWhether to use the AMS; defaults to auto-detect from the 3MF mapping.
bed_typeNoBed plate type currently installed (default: textured_plate).
passwordNoPrinter password/access code override for LAN/local bridge methods.
usernameNoPrinter username for LAN/local bridge methods; defaults to bblp.
ams_slotsNoPer-used-filament AMS slot list, matching the local LAN print path (254/255 external spool rules as in print_3mf).
task_nameNoOptional project label when project_name is omitted. The submitted task name uses a unique inspected-job identity for safe resume.
timelapseNoEnable timelapse recording in FULU PrintParams (default: false).
user_infoNoOptional BambuNetwork user_info JSON string to pass to net.change_user after the agent starts.
timeout_msNoBridge request timeout in milliseconds.
ams_mappingNoAMS slot mapping array used by both local MCP printing and FULU PrintParams. Same tray values as print_3mf: 254 = external spool; on dual-nozzle printers 254 = left/deputy nozzle external and 255 = right/main nozzle external.
bambu_modelYesREQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer.
bambu_tokenNoPrinter access code/password for LAN/local bridge methods.
nozzle_typeNoInstalled nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle).
plate_indexNoZero-based plate index to print from the sliced 3MF; converted to FULU's one-based PrintParams plate_index.
preset_nameNoOptional preset name sent in FULU PrintParams; defaults to project plus one-based plate index.
slicer_pathNoPath to the slicer executable for auto-slicing; defaults to value from env or a platform default. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1.
slicer_typeNoSlicer to use only if auto-slicing an unsliced 3MF; use orcaslicer-bambulab for FULU's fork.
ams_mapping2NoRaw JSON string for FULU PrintParams ams_mapping2, matching OrcaSlicer-bambulab's v1 AMS mapping field.
bambu_serialNoFallback Bambu device id when dev_id is not supplied.
bed_levelingNoAuto bed leveling on or off. Omit to send what Bambu Studio's Send dialog would: the choice saved in BambuStudio.conf for this printer, else Studio's default.
country_codeNoBambuNetwork country code, such as US, used by the agent during startup.
nozzles_infoNoRaw JSON string for FULU PrintParams nozzles_info.
project_nameNoOptional project name returned in the result; defaults to the 3MF filename without extension. The printer job and stored file use the server's unique checked name so resume_print can bind to the inspected file.
client_job_idNoOptional client job id sent to the bridge; defaults to the current timestamp.
extra_optionsNoRaw JSON string or text for FULU PrintParams extra_options.
layer_inspectNoFirst-layer inspection where supported (default true, as Bambu Studio sends).
three_mf_pathYesPath to the 3MF file to print; unsliced 3MFs are auto-sliced before sending.
bridge_commandNoOverride command for the FULU bridge host or macOS/WSL wrapper; defaults to BAMBU_NETWORK_BRIDGE_COMMAND. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1.
nozzle_mappingNoRaw JSON string for FULU PrintParams nozzle_mapping.
slicer_profileNoPath to an optional slicer profile/config file for auto-slicing.
try_emmc_printNoStore the job on internal storage (eMMC) instead of the SD card or USB stick. FULU bridge: default false. X2D native printing: omit to use a ready card, else eMMC.
config_filenameNoOptional config 3MF path for cloud print; defaults to the same 3MF path.
connection_typeNoBambuNetwork connection type to put in FULU PrintParams; cloud uses restored internet printing, lan uses local bridge printing.
nozzle_diameterNoNozzle diameter in mm for auto-slicing (default: 0.4).
use_ssl_for_ftpNoWhether FULU local print should use SSL for FTP (default: true).
ams_mapping_infoNoRaw JSON string for FULU PrintParams ams_mapping_info, matching OrcaSlicer-bambulab's detailed AMS mapping field.
flow_calibrationNoFlow calibration task boolean. Omission resolves Studio settings (auto on P1/P1S); direct MQTT sends false for auto but does not transmit the integer auto mode. The result calibration report distinguishes resolved and transmitted options.
nozzle_diametersNoComplete per-nozzle diameters for pre-sliced jobs, e.g. [0.4, 0.6]. Omit to verify file metadata against every reported nozzle; cannot combine with nozzle_diameter.
use_ssl_for_mqttNoWhether FULU local print should use SSL for MQTT (default: true).
ams_mapping_bridgeNoRaw JSON string override for FULU PrintParams ams_mapping when the automatic array is not enough.
nozzle_volume_typeNoInstalled nozzle flow type, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_VOLUME_TYPE, else standard).
bambu_network_methodNoFULU print method to invoke; defaults to start_local_print for lan, and for cloud to Bambu Studio's order: start_local_print_with_record, then start_print if that fails.
vibration_calibrationNoVibration calibration (default false, as Bambu Studio sends).
external_change_assistNoEnable FULU PrintParams task_ext_change_assist for external filament change assistance.
bambu_network_config_dirNoConfig/log directory used by the BambuNetwork agent; defaults to BAMBU_NETWORK_CONFIG_DIR or a user config directory.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.1.93
    • changedInput schema / properties / flow_calibration / description
      Previous value: -"Flow calibration on or off. Omit to send what Bambu Studio's Send dialog would (auto on P1/P1S)."New value: +"Flow calibration task boolean. Omission resolves Studio settings (auto on P1/P1S); direct MQTT sends false for auto but does not transmit the integer auto mode. The result calibration report distinguishes resolved and transmitted options."
  2. Changed1 schema field changedv1.1.61
    • changedInput schema / properties / bambu_network_method / description
      Previous value: -"FULU print method to invoke; defaults to start_print for cloud and start_local_print for lan."New value: +"FULU print method to invoke; defaults to start_local_print for lan, and for cloud to Bambu Studio's order: start_local_print_with_record, then start_print if that fails."
  3. Changed4 schema fields changedv1.1.51
    • changedInput schema / properties / bed_leveling / description
      Previous value: -"Enable auto bed leveling in FULU PrintParams (default: true)."New value: +"Auto bed leveling on or off. Omit to send what Bambu Studio's Send dialog would: the choice saved in BambuStudio.conf for this printer, else Studio's default."
    • changedInput schema / properties / flow_calibration / description
      Previous value: -"Enable flow calibration in FULU PrintParams (default: true)."New value: +"Flow calibration on or off. Omit to send what Bambu Studio's Send dialog would (auto on P1/P1S)."
    • changedInput schema / properties / layer_inspect / description
      Previous value: -"Enable first-layer inspection where supported (default: false for BambuNetwork bridge)."New value: +"First-layer inspection where supported (default true, as Bambu Studio sends)."
    • changedInput schema / properties / vibration_calibration / description
      Previous value: -"Enable vibration calibration in FULU PrintParams (default: true)."New value: +"Vibration calibration (default false, as Bambu Studio sends)."
  4. Changed1 schema field changedv1.1.42
    • changedInput schema / properties / bambu_model / enum
      Previous value: -[
      -  "p1s",
      -  "p1p",
      -  "p2s",
      -  "x1c",
      -  "x1e",
      -  "a1",
      -  "a1mini",
      -  "h2d",
      -  "h2s",
      -  "h2c",
      -  "x2d"
      -]New value: +[
      +  "p1s",
      +  "p1p",
      +  "p2s",
      +  "x1c",
      +  "x1e",
      +  "a1",
      +  "a1mini",
      +  "h2d",
      +  "h2dpro",
      +  "h2s",
      +  "h2c",
      +  "x2d"
      +]
  5. Changed1 schema field changedv1.1.37
    • changedInput schema / properties / project_name / description
      Previous value: -"Optional project name sent in FULU PrintParams; defaults to the 3MF filename without extension."New value: +"Optional project name returned in the result; defaults to the 3MF filename without extension. The printer job and stored file use the server's unique checked name so resume_print can bind to the inspected file."
  6. Changed1 schema field changedv1.1.32
    • changedInput schema / properties / try_emmc_print / description
      Previous value: -"Enable FULU PrintParams try_emmc_print for printers that support internal storage printing."New value: +"Store the job on internal storage (eMMC) instead of the SD card or USB stick. FULU bridge: default false. X2D native printing: omit to use a ready card, else eMMC."
  7. Changed4 schema fields changedv1.1.31
    • changedInput schema / properties / ams_mapping / description
      Previous value: -"AMS slot mapping array used by both local MCP printing and FULU PrintParams."New value: +"AMS slot mapping array used by both local MCP printing and FULU PrintParams. Same tray values as print_3mf: 254 = external spool; on dual-nozzle printers 254 = left/deputy nozzle external and 255 = right/main nozzle external."
    • changedInput schema / properties / ams_slots / description
      Previous value: -"Per-used-filament AMS slot list, matching the local LAN print path."New value: +"Per-used-filament AMS slot list, matching the local LAN print path (254/255 external spool rules as in print_3mf)."
    • addedInput schema / properties / nozzle_volume_type
      Added value: +{
      +  "description": "Installed nozzle flow type, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_VOLUME_TYPE, else standard).",
      +  "enum": [
      +    "standard",
      +    "high_flow"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / slicer_type / enum
      Previous value: -[
      -  "bambustudio",
      -  "orcaslicer",
      -  "orcaslicer-bambulab",
      -  "prusaslicer",
      -  "cura",
      -  "slic3r",
      -  "fulu-orca",
      -  "fulu-orcaslicer",
      -  "orca-studio",
      -  "orca-bambulab"
      -]New value: +[
      +  "bambustudio",
      +  "orcaslicer",
      +  "orcaslicer-bambulab",
      +  "orca-slicer-api",
      +  "prusaslicer",
      +  "cura",
      +  "slic3r",
      +  "fulu-orca",
      +  "fulu-orcaslicer",
      +  "orca-studio",
      +  "orca-bambulab"
      +]
  8. Changed1 schema field changedv1.1.22
    • addedInput schema / properties / nozzle_type
      Added value: +{
      +  "description": "Installed nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle).",
      +  "enum": [
      +    "stainless_steel",
      +    "hardened_steel",
      +    "tungsten_carbide",
      +    "brass"
      +  ],
      +  "type": "string"
      +}
  9. Changed5 schema fields changedv1.1.14
    • changedInput schema / properties / bambu_model / enum
      Previous value: -[
      -  "p1s",
      -  "p1p",
      -  "p2s",
      -  "x1c",
      -  "x1e",
      -  "a1",
      -  "a1mini",
      -  "h2d",
      -  "h2s"
      -]New value: +[
      +  "p1s",
      +  "p1p",
      +  "p2s",
      +  "x1c",
      +  "x1e",
      +  "a1",
      +  "a1mini",
      +  "h2d",
      +  "h2s",
      +  "h2c",
      +  "x2d"
      +]
    • changedInput schema / properties / bridge_command / description
      Previous value: -"Override command for the FULU bridge host or macOS/WSL wrapper; defaults to BAMBU_NETWORK_BRIDGE_COMMAND."New value: +"Override command for the FULU bridge host or macOS/WSL wrapper; defaults to BAMBU_NETWORK_BRIDGE_COMMAND. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1."
    • addedInput schema / properties / nozzle_diameters
      Added value: +{
      +  "description": "Complete per-nozzle diameters for pre-sliced jobs, e.g. [0.4, 0.6]. Omit to verify file metadata against every reported nozzle; cannot combine with nozzle_diameter.",
      +  "items": {
      +    "enum": [
      +      0.2,
      +      0.4,
      +      0.6,
      +      0.8
      +    ],
      +    "type": "number"
      +  },
      +  "maxItems": 2,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / slicer_path / description
      Previous value: -"Path to the slicer executable for auto-slicing; defaults to value from env or a platform default."New value: +"Path to the slicer executable for auto-slicing; defaults to value from env or a platform default. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1."
    • changedInput schema / properties / task_name / description
      Previous value: -"Optional BambuNetwork task name; defaults to the project name."New value: +"Optional project label when project_name is omitted. The submitted task name uses a unique inspected-job identity for safe resume."
  10. First observedv1.1.1

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this as destructive, non-idempotent, open-world, and not read-only, so the description does not need to restate the safety profile. The description adds route context about the BambuNetwork path, but it does not disclose what the print operation changes on the printer, failure behavior, or authorization needs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is a single front-loaded sentence with no unnecessary wording. It immediately names the action and the path distinction.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex destructive print tool, the description is adequate at the route-selection level and the schema covers the many parameters thoroughly. However, it is very terse about operational consequences and when the FULU BambuNetwork path is preferred, leaving the definition minimally complete rather than rich.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the 48 parameters are already documented in the schema. The description adds no parameter-level meaning beyond that, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: "Print a 3MF." It also identifies the distinctive route, FULU OrcaSlicer-bambulab's restored BambuNetwork path, and explicitly contrasts it with the MCP LAN MQTT/FTPS path.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase "instead of the MCP LAN MQTT/FTPS path" gives clear alternative-path guidance, making it usable for route selection. It does not spell out explicit when-not conditions or prerequisites such as cloud vs LAN choice beyond the path contrast.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.