mcp-3d-printer-server 1.2.27 → 1.2.29

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.2.29] – 2026-11-04
+
+### Changed
+
+- With no method given, a FULU print over Bambu Cloud goes the way Bambu Studio sends it to a cloud-bound printer it can reach on the LAN (`PrintJob.cpp`): `start_local_print_with_record`, which uploads to the printer over the LAN and records the task in the account, in the account's cloud session. When that fails before the print command (the plug-in's `-2010` to `-2140` preparation results, other than a missing or oversized file), the same checked job goes once through `start_print`, with the printer checked again first. Any other failure may have reached the printer and is not sent again. A printer that reports no storage goes straight to `start_print`, as in Studio. Same change as bambu-printer-mcp 1.1.55. On a P1S with firmware 01.10.00.00, `start_print` alone returns `-3120`, HTTP 403 "internal blocking", every time. Errors name `-2120`, `-2130` and `-3120`. Checked with the stand-in host and intercepted transports only; not yet on a printer.
+
+## [1.2.28] – 2026-11-04
+
+### Added
+
+- `slice_stl` takes `enable_support`, `support_type` (`normal(auto)`, `tree(auto)`, `normal(manual)`, `tree(manual)`) and `support_threshold_angle`, written over the selected process profile like `layer_height` and `wall_loops`. Bambu Studio and OrcaSlicer only; PrusaSlicer and Cura refuse them. Tested with the fake Bambu Studio CLI install; bambu-printer-mcp 1.1.54 checks the same keys against the installed Bambu Studio 02.08.02.61. No printer was involved.
+
 ## [1.2.27] – 2026-11-04
 
 ### Added

package/README.md

@@ -690,6 +690,8 @@ Options for the Bambu-compatible path:
 
 `layer_height` (mm), `wall_loops` (a whole number), and `sparse_infill_density` (such as `"15%"`) are written over the selected profile on every slicer: as the process keys `layer_height`, `wall_loops`, and `sparse_infill_density` for Bambu Studio and OrcaSlicer, and as `--layer-height`, `--perimeters`, and `--fill-density` for PrusaSlicer and Slic3r. They win over a template. Cura refuses them; set them in its definition file. Your profile files are never modified.
 
+`enable_support` (true or false), `support_type` (`normal(auto)`, `tree(auto)`, `normal(manual)` or `tree(manual)`) and `support_threshold_angle` (0 to 90 degrees; 0 lets the slicer decide) are written over the selected process profile as the same-named Bambu Studio and OrcaSlicer keys. PrusaSlicer, Slic3r and Cura refuse them; set supports in their own profile.
+
 Generic slicers keep their own profile formats: PrusaSlicer and Slic3r load one exported config, plus an optional filament preset `.ini` from `load_filaments`, and generic OrcaSlicer takes `machine.json;process.json`, optionally followed by `|filament.json`. `slicer_type`, `slicer_profile`, and `filament_profile` fall back to `SLICER_TYPE`, `SLICER_PROFILE`, and `FILAMENT_PROFILE`. The slicer executable comes from `SLICER_PATH`; a per-call `slicer_path` requires `MCP_ALLOW_EXECUTABLE_ARG=1`. See the [slicing guide](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/SLICING.md#bambu-compatible-slicing).
 
 #### slice_with_template

package/dist/bambu-network-bridge.d.ts

@@ -186,10 +186,16 @@ export declare class BambuNetworkBridge {
      * Shares the LAN session queue: one reader of the plug-in's events at a time.
      */
     withCloudSession<T>(devId: string, options: BambuNetworkBridgeOptions, assertActive: () => void, timing: Readonly<CloudTiming>, run: (session: CloudSession) => Promise<T>): Promise<T>;
-    /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
-    startCloudPrint(devId: string, method: string, payload: JsonObject, options?: BambuNetworkBridgeOptions, assertActive?: () => void, timing?: Readonly<CloudTiming>): Promise<{
+    /**
+     * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+     * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+     * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+     * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+     */
+    startCloudPrint(devId: string, method: string, payload: JsonObject, options?: BambuNetworkBridgeOptions, assertActive?: () => void, timing?: Readonly<CloudTiming>, fallbackMethod?: string): Promise<{
         result: unknown;
         jobUpdates: BridgeJobUpdate[];
+        firstFailure?: number;
     }>;
     /**
      * A print control over Bambu Cloud: how Bambu Studio and FULU's slicer control a printer

package/dist/bambu-network-bridge.js

@@ -21,8 +21,16 @@ const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
 const LOCAL_CONNECT_STATUS = ["ok", "failed", "lost"];
 // bambu_networking.hpp BAMBU_NETWORK_ERR_PRINT_LP_PUBLISH_MSG_FAILED.
 const LOCAL_PRINT_PUBLISH_FAILED = -4030;
+// A with-record send falls back to start_print only on its own preparation failures (the plug-in's
+// PRINT_WR_* results, -2010 to -2140: project, upload, task record, FTPS), which come before the print
+// command, so the printer has no job. Any other result may have reached the printer and is never
+// replayed. Of those, Studio also stops on a file missing or too large (should_stop_without_fallback).
+const WITH_RECORD_PREPARATION_FAILURE = (value) => value <= -2010 && value >= -2140 && value !== -2040 && value !== -2100;
 // bambu_networking.hpp print errors that name a recoverable cause.
 const BAMBU_NETWORK_PRINT_ERRORS = {
+    [-2120]: "Bambu Cloud refused to create the print task",
+    [-2130]: "FTPS upload to the printer failed",
+    [-3120]: "Bambu Cloud refused to create the print task",
     [-4010]: "the file exceeds the 1 GB upload limit",
     [-4020]: "FTPS upload to the printer failed",
     [LOCAL_PRINT_PUBLISH_FAILED]: "the networking plug-in could not send the print command to the printer over MQTT",
@@ -703,9 +711,23 @@ export class BambuNetworkBridge {
             release();
         }
     }
-    /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
-    async startCloudPrint(devId, method, payload, options = {}, assertActive = () => { }, timing = CLOUD_PRINT_TIMING) {
-        return await this.withCloudSession(devId, options, assertActive, timing, async (session) => ({ result: await this.callWithAgent(method, payload, options), jobUpdates: session.jobUpdates }));
+    /**
+     * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+     * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+     * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+     * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+     */
+    async startCloudPrint(devId, method, payload, options = {}, assertActive = () => { }, timing = CLOUD_PRINT_TIMING, fallbackMethod) {
+        return await this.withCloudSession(devId, options, assertActive, timing, async (session) => {
+            const result = await this.callWithAgent(method, payload, options);
+            const value = bridgeNumericResult(result);
+            if (!fallbackMethod || value === undefined || !WITH_RECORD_PREPARATION_FAILURE(value))
+                return { result, jobUpdates: session.jobUpdates };
+            options.trace?.({ step: "fallback", from: method, to: fallbackMethod, result: value });
+            const params = payload.params;
+            const fallbackPayload = params ? { ...payload, params: { ...params, comments: `failed(${value})` } } : payload;
+            return { result: await this.callWithAgent(fallbackMethod, fallbackPayload, options), jobUpdates: session.jobUpdates, firstFailure: value };
+        });
     }
     /**
      * A print control over Bambu Cloud: how Bambu Studio and FULU's slicer control a printer

package/dist/index.js

@@ -17,7 +17,7 @@ import { createServer as createHttpServer } from "node:http";
 import { randomUUID } from "node:crypto";
 import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
-import { STLManipulator } from "./stl/stl-manipulator.js";
+import { STLManipulator, SUPPORT_TYPES } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
@@ -34,7 +34,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError } from "./bambu-netw
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -318,6 +318,12 @@ const SLICE_TOOL_PROPERTIES = {
         type: "string",
         description: "Sparse infill density such as \"15%\" (0–100%), written over the selected process profile (Orca/Bambu Studio sparse_infill_density; PrusaSlicer --fill-density). Not mapped for Cura.",
     },
+    enable_support: { type: "boolean", description: "Turn support generation on or off (Orca/Bambu Studio enable_support), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+    support_type: { type: "string", enum: [...SUPPORT_TYPES], description: "Support style (Orca/Bambu Studio support_type), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+    support_threshold_angle: {
+        type: "integer", minimum: 0, maximum: 90,
+        description: "Overhang threshold in degrees for automatic supports (Orca/Bambu Studio support_threshold_angle; 0 lets the slicer decide). Bambu Studio and OrcaSlicer only.",
+    },
 };
 /**
  * upload_gcode / start_print results name the remote file that was stored or
@@ -348,7 +354,7 @@ const OUTPUT_SCHEMA_TOOLS = new Set([
     "camera_stream_start", "camera_frame", "camera_stream_stop",
     "fusion_mcp_status", "fusion_mcp_call", "fusion_mcp_new_design", "fusion_mcp_export",
 ]);
-/** layer_height / wall_loops / sparse_infill_density (PRD §8.4), validated before slicing. */
+/** layer_height / wall_loops / sparse_infill_density / support settings (PRD §8.4), validated before slicing. */
 function parseProcessOverrides(args) {
     const overrides = {};
     if (args?.layer_height !== undefined) {
@@ -375,6 +381,25 @@ function parseProcessOverrides(args) {
         }
         overrides.sparseInfillDensity = `${value}%`;
     }
+    if (args?.enable_support !== undefined) {
+        if (typeof args.enable_support !== "boolean")
+            throw new Error("Invalid enable_support: expected true or false.");
+        overrides.enableSupport = args.enable_support;
+    }
+    if (args?.support_type !== undefined) {
+        const value = args.support_type;
+        if (typeof value !== "string" || !SUPPORT_TYPES.includes(value)) {
+            throw new Error(`Invalid support_type: expected one of ${SUPPORT_TYPES.join(", ")}.`);
+        }
+        overrides.supportType = value;
+    }
+    if (args?.support_threshold_angle !== undefined) {
+        const value = args.support_threshold_angle;
+        if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > 90) {
+            throw new Error("Invalid support_threshold_angle: expected an integer number of degrees from 0 to 90.");
+        }
+        overrides.supportThresholdAngle = value;
+    }
     return overrides;
 }
 function validateSliceBambuModel(model) {
@@ -856,8 +881,10 @@ class ThreeDPrinterMCPServer {
             throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
         }
         const isLocalBridgePrint = connectionType === "lan";
-        const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-        const bridgeMethod = `net.${bridgePrintMethod}`;
+        // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+        // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+        let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+        let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
         const { plateIndex } = options;
         const threeMfFilename = path.basename(options.threeMFPath);
         const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -898,6 +925,11 @@ class ThreeDPrinterMCPServer {
             validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
             const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
             validatePrinterState(confirmedStatus, requirements);
+            if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+                // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+                bridgeMethod = cloudFallbackMethod;
+                cloudFallbackMethod = undefined;
+            }
             const wireMapping = mapping.map((value) => bridgeAmsMappingValue(value, dualNozzle));
             const remoteFileName = uniquePrintName(options.threeMFPath);
             const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -954,23 +986,29 @@ class ThreeDPrinterMCPServer {
             const bridgeOptions = {
                 // Trusted in-process preflight immediately before the print frame.
                 beforeDispatch: async (method) => {
-                    if (method !== bridgeMethod)
+                    if (method !== bridgeMethod && method !== cloudFallbackMethod)
                         return;
                     assertActive();
                     validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
                 },
-                assertDispatchAllowed: (method) => { if (method === bridgeMethod)
+                assertDispatchAllowed: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     assertActive(); },
-                onDispatched: (method) => { if (method === bridgeMethod)
+                onDispatched: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     retainForDispatchedUpload(); },
             };
             let jobUpdates = [];
             let bridgeResult;
+            let firstAttempt = "";
             if (isLocalBridgePrint) {
                 ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint({ devId, devIp, username: "bblp", password, useSsl: true }, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
             }
             else {
-                ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+                let firstFailure;
+                ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+                if (firstFailure !== undefined) {
+                    bridgeMethod = cloudFallbackMethod;
+                    firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+                }
             }
             if (typeof bridgeResult === "object" && bridgeResult !== null && bridgeResult.ok === false) {
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String(bridgeResult.error || "unknown bridge error")}`);
@@ -980,14 +1018,14 @@ class ThreeDPrinterMCPServer {
                 const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
                     .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-                    (reported ? ` Plug-in reported: ${reported}.` : ""));
+                    (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
             }
             assertActive();
             // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
             bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
             return {
                 status: "success",
-                message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+                message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
                 connectionMode: "bambu_network",
                 connectionType,
                 bridgeMethod,

package/dist/stl/stl-manipulator.d.ts

@@ -15,7 +15,14 @@ export interface ProcessOverrides {
     wallLoops?: number;
     /** e.g. "15%" */
     sparseInfillDensity?: string;
+    enableSupport?: boolean;
+    /** normal(auto), tree(auto), normal(manual) or tree(manual) */
+    supportType?: string;
+    /** degrees, 0-90 */
+    supportThresholdAngle?: number;
 }
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export declare const SUPPORT_TYPES: readonly ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"];
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
 export declare function orcaProcessOverrides(overrides: ProcessOverrides | undefined): Record<string, string>;
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */

package/dist/stl/stl-manipulator.js

@@ -13,6 +13,16 @@ import { BambuCliProfilePreparer, assertSlicedProjectOutput, bambuCliFailureReas
 import { runSlicerProcess } from '../slicer/run-slicer.js';
 import { SlicerError, asPreparationError } from '../slicer/slicer-error.js';
 import { customGcodesWithPauses, layerTops, machinePauseGcode, pausedLayers, readPlateGcode, readProjectCustomGcodes } from '../slicer/layer-pauses.js';
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export const SUPPORT_TYPES = ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"];
+/** Support overrides only Bambu Studio and OrcaSlicer take; PrusaSlicer and Cura refuse them. */
+function supportOverrideNames(overrides) {
+    return [
+        overrides?.enableSupport !== undefined ? "enable_support" : "",
+        overrides?.supportType !== undefined ? "support_type" : "",
+        overrides?.supportThresholdAngle !== undefined ? "support_threshold_angle" : "",
+    ].filter(Boolean);
+}
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
 export function orcaProcessOverrides(overrides) {
     const keys = {};
@@ -22,10 +32,19 @@ export function orcaProcessOverrides(overrides) {
         keys.wall_loops = String(overrides.wallLoops);
     if (overrides?.sparseInfillDensity !== undefined)
         keys.sparse_infill_density = overrides.sparseInfillDensity;
+    if (overrides?.enableSupport !== undefined)
+        keys.enable_support = overrides.enableSupport ? "1" : "0";
+    if (overrides?.supportType !== undefined)
+        keys.support_type = overrides.supportType;
+    if (overrides?.supportThresholdAngle !== undefined)
+        keys.support_threshold_angle = String(overrides.supportThresholdAngle);
     return keys;
 }
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */
 export function prusaSlicerOverrideArgs(overrides) {
+    const unsupported = supportOverrideNames(overrides);
+    if (unsupported.length)
+        throw new Error(`${unsupported.join(", ")} apply to Bambu Studio and OrcaSlicer only; set them in the PrusaSlicer config passed as slicer_profile.`);
     const args = [];
     if (overrides?.layerHeight !== undefined)
         args.push('--layer-height', String(overrides.layerHeight));
@@ -1000,7 +1019,7 @@ export class STLManipulator extends EventEmitter {
                         break;
                     case 'cura':
                         if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
-                            throw new SlicerError('preparation', 'layer_height, wall_loops and sparse_infill_density are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
+                            throw new SlicerError('preparation', 'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
                         }
                         // CuraEngine CLI args are different, often requiring -s for settings
                         // Example: curaengine slice -v -j cura_settings.json -s layer_height=0.2 -o output.gcode -l input.stl

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.27",
+    "version": "1.2.29",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/DMontgomery40/mcp-3D-printer-server",
     "source": "github"
   },
-  "version": "1.2.27",
+  "version": "1.2.29",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.27",
+      "version": "1.2.29",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/bambu-network-bridge.ts

@@ -23,8 +23,16 @@ const DEFAULT_REQUEST_TIMEOUT_MS = 120_000;
 const LOCAL_CONNECT_STATUS = ["ok", "failed", "lost"];
 // bambu_networking.hpp BAMBU_NETWORK_ERR_PRINT_LP_PUBLISH_MSG_FAILED.
 const LOCAL_PRINT_PUBLISH_FAILED = -4030;
+// A with-record send falls back to start_print only on its own preparation failures (the plug-in's
+// PRINT_WR_* results, -2010 to -2140: project, upload, task record, FTPS), which come before the print
+// command, so the printer has no job. Any other result may have reached the printer and is never
+// replayed. Of those, Studio also stops on a file missing or too large (should_stop_without_fallback).
+const WITH_RECORD_PREPARATION_FAILURE = (value: number) => value <= -2010 && value >= -2140 && value !== -2040 && value !== -2100;
 // bambu_networking.hpp print errors that name a recoverable cause.
 const BAMBU_NETWORK_PRINT_ERRORS: Record<number, string> = {
+  [-2120]: "Bambu Cloud refused to create the print task",
+  [-2130]: "FTPS upload to the printer failed",
+  [-3120]: "Bambu Cloud refused to create the print task",
   [-4010]: "the file exceeds the 1 GB upload limit",
   [-4020]: "FTPS upload to the printer failed",
   [LOCAL_PRINT_PUBLISH_FAILED]: "the networking plug-in could not send the print command to the printer over MQTT",
@@ -853,10 +861,24 @@ export class BambuNetworkBridge {
     }
   }
 
-  /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
+  /**
+   * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+   * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+   * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+   * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+   */
   async startCloudPrint(devId: string, method: string, payload: JsonObject, options: BambuNetworkBridgeOptions = {},
-    assertActive: () => void = () => {}, timing: Readonly<CloudTiming> = CLOUD_PRINT_TIMING): Promise<{ result: unknown; jobUpdates: BridgeJobUpdate[] }> {
-    return await this.withCloudSession(devId, options, assertActive, timing, async session => ({ result: await this.callWithAgent(method, payload, options), jobUpdates: session.jobUpdates }));
+    assertActive: () => void = () => {}, timing: Readonly<CloudTiming> = CLOUD_PRINT_TIMING, fallbackMethod?: string
+  ): Promise<{ result: unknown; jobUpdates: BridgeJobUpdate[]; firstFailure?: number }> {
+    return await this.withCloudSession(devId, options, assertActive, timing, async session => {
+      const result = await this.callWithAgent(method, payload, options);
+      const value = bridgeNumericResult(result);
+      if (!fallbackMethod || value === undefined || !WITH_RECORD_PREPARATION_FAILURE(value)) return { result, jobUpdates: session.jobUpdates };
+      options.trace?.({ step: "fallback", from: method, to: fallbackMethod, result: value });
+      const params = (payload as { params?: JsonObject }).params;
+      const fallbackPayload = params ? { ...payload, params: { ...params, comments: `failed(${value})` } } : payload;
+      return { result: await this.callWithAgent(fallbackMethod, fallbackPayload, options), jobUpdates: session.jobUpdates, firstFailure: value };
+    });
   }
 
   /**

package/src/index.ts

@@ -34,7 +34,7 @@ import { createServer as createHttpServer, type IncomingMessage, type Server as
 import { randomUUID } from "node:crypto";
 import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
-import { STLManipulator, type BambuSliceOptions, type ProcessOverrides, type SliceOutput } from "./stl/stl-manipulator.js";
+import { STLManipulator, SUPPORT_TYPES, type BambuSliceOptions, type ProcessOverrides, type SliceOutput } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
 import { CounterpartService, type BambuControlRoute, type PrinterTarget } from "./counterpart/service.js";
 import {CAMERA_STREAM_TOOLS} from "./counterpart/camera-tools.js";
@@ -75,7 +75,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError, type BridgeJobUpdat
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues, type PrintRoute } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount, type CallerPrintOptions } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -396,6 +396,12 @@ const SLICE_TOOL_PROPERTIES = {
     type: "string",
     description: "Sparse infill density such as \"15%\" (0–100%), written over the selected process profile (Orca/Bambu Studio sparse_infill_density; PrusaSlicer --fill-density). Not mapped for Cura.",
   },
+  enable_support: { type: "boolean", description: "Turn support generation on or off (Orca/Bambu Studio enable_support), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+  support_type: { type: "string", enum: [...SUPPORT_TYPES], description: "Support style (Orca/Bambu Studio support_type), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+  support_threshold_angle: {
+    type: "integer", minimum: 0, maximum: 90,
+    description: "Overhang threshold in degrees for automatic supports (Orca/Bambu Studio support_threshold_angle; 0 lets the slicer decide). Bambu Studio and OrcaSlicer only.",
+  },
 };
 
 /**
@@ -428,7 +434,7 @@ const OUTPUT_SCHEMA_TOOLS = new Set([
   "fusion_mcp_status", "fusion_mcp_call", "fusion_mcp_new_design", "fusion_mcp_export",
 ]);
 
-/** layer_height / wall_loops / sparse_infill_density (PRD §8.4), validated before slicing. */
+/** layer_height / wall_loops / sparse_infill_density / support settings (PRD §8.4), validated before slicing. */
 function parseProcessOverrides(args: Record<string, unknown> | undefined): ProcessOverrides {
   const overrides: ProcessOverrides = {};
   if (args?.layer_height !== undefined) {
@@ -455,6 +461,24 @@ function parseProcessOverrides(args: Record<string, unknown> | undefined): Proce
     }
     overrides.sparseInfillDensity = `${value}%`;
   }
+  if (args?.enable_support !== undefined) {
+    if (typeof args.enable_support !== "boolean") throw new Error("Invalid enable_support: expected true or false.");
+    overrides.enableSupport = args.enable_support;
+  }
+  if (args?.support_type !== undefined) {
+    const value = args.support_type;
+    if (typeof value !== "string" || !(SUPPORT_TYPES as readonly string[]).includes(value)) {
+      throw new Error(`Invalid support_type: expected one of ${SUPPORT_TYPES.join(", ")}.`);
+    }
+    overrides.supportType = value;
+  }
+  if (args?.support_threshold_angle !== undefined) {
+    const value = args.support_threshold_angle;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > 90) {
+      throw new Error("Invalid support_threshold_angle: expected an integer number of degrees from 0 to 90.");
+    }
+    overrides.supportThresholdAngle = value;
+  }
   return overrides;
 }
 
@@ -1050,8 +1074,10 @@ class ThreeDPrinterMCPServer {
       throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
     }
     const isLocalBridgePrint = connectionType === "lan";
-    const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-    const bridgeMethod = `net.${bridgePrintMethod}`;
+    // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+    // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+    let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+    let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
     const { plateIndex } = options;
     const threeMfFilename = path.basename(options.threeMFPath);
     const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -1092,6 +1118,11 @@ class ThreeDPrinterMCPServer {
       validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
       const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
       validatePrinterState(confirmedStatus, requirements);
+      if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+        // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+        bridgeMethod = cloudFallbackMethod;
+        cloudFallbackMethod = undefined;
+      }
       const wireMapping = mapping!.map((value) => bridgeAmsMappingValue(value, dualNozzle));
       const remoteFileName = uniquePrintName(options.threeMFPath);
       const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -1148,22 +1179,28 @@ class ThreeDPrinterMCPServer {
       const bridgeOptions = {
         // Trusted in-process preflight immediately before the print frame.
         beforeDispatch: async (method: string) => {
-          if (method !== bridgeMethod) return;
+          if (method !== bridgeMethod && method !== cloudFallbackMethod) return;
           assertActive();
           validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
         },
-        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod) assertActive(); },
-        onDispatched: (method: string) => { if (method === bridgeMethod) retainForDispatchedUpload(); },
+        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) assertActive(); },
+        onDispatched: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) retainForDispatchedUpload(); },
       };
       let jobUpdates: BridgeJobUpdate[] = [];
       let bridgeResult: unknown;
+      let firstAttempt = "";
       if (isLocalBridgePrint) {
         ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint(
           { devId, devIp, username: "bblp", password, useSsl: true },
           bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive
         ));
       } else {
-        ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+        let firstFailure: number | undefined;
+        ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+        if (firstFailure !== undefined) {
+          bridgeMethod = cloudFallbackMethod!;
+          firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+        }
       }
       if (typeof bridgeResult === "object" && bridgeResult !== null && (bridgeResult as { ok?: unknown }).ok === false) {
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String((bridgeResult as { error?: unknown }).error || "unknown bridge error")}`);
@@ -1173,14 +1210,14 @@ class ThreeDPrinterMCPServer {
         const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
           .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-          (reported ? ` Plug-in reported: ${reported}.` : ""));
+          (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
       }
       assertActive();
       // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
       bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
       return {
         status: "success",
-        message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+        message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
         connectionMode: "bambu_network",
         connectionType,
         bridgeMethod,

package/src/stl/stl-manipulator.ts

@@ -36,6 +36,23 @@ export interface ProcessOverrides {
   wallLoops?: number;
   /** e.g. "15%" */
   sparseInfillDensity?: string;
+  enableSupport?: boolean;
+  /** normal(auto), tree(auto), normal(manual) or tree(manual) */
+  supportType?: string;
+  /** degrees, 0-90 */
+  supportThresholdAngle?: number;
+}
+
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export const SUPPORT_TYPES = ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"] as const;
+
+/** Support overrides only Bambu Studio and OrcaSlicer take; PrusaSlicer and Cura refuse them. */
+function supportOverrideNames(overrides: ProcessOverrides | undefined): string[] {
+  return [
+    overrides?.enableSupport !== undefined ? "enable_support" : "",
+    overrides?.supportType !== undefined ? "support_type" : "",
+    overrides?.supportThresholdAngle !== undefined ? "support_threshold_angle" : "",
+  ].filter(Boolean);
 }
 
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
@@ -44,11 +61,16 @@ export function orcaProcessOverrides(overrides: ProcessOverrides | undefined): R
   if (overrides?.layerHeight !== undefined) keys.layer_height = String(overrides.layerHeight);
   if (overrides?.wallLoops !== undefined) keys.wall_loops = String(overrides.wallLoops);
   if (overrides?.sparseInfillDensity !== undefined) keys.sparse_infill_density = overrides.sparseInfillDensity;
+  if (overrides?.enableSupport !== undefined) keys.enable_support = overrides.enableSupport ? "1" : "0";
+  if (overrides?.supportType !== undefined) keys.support_type = overrides.supportType;
+  if (overrides?.supportThresholdAngle !== undefined) keys.support_threshold_angle = String(overrides.supportThresholdAngle);
   return keys;
 }
 
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */
 export function prusaSlicerOverrideArgs(overrides: ProcessOverrides | undefined): string[] {
+  const unsupported = supportOverrideNames(overrides);
+  if (unsupported.length) throw new Error(`${unsupported.join(", ")} apply to Bambu Studio and OrcaSlicer only; set them in the PrusaSlicer config passed as slicer_profile.`);
   const args: string[] = [];
   if (overrides?.layerHeight !== undefined) args.push('--layer-height', String(overrides.layerHeight));
   if (overrides?.wallLoops !== undefined) args.push('--perimeters', String(overrides.wallLoops));
@@ -1295,7 +1317,7 @@ export class STLManipulator extends EventEmitter {
           case 'cura':
             if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
               throw new SlicerError('preparation',
-                'layer_height, wall_loops and sparse_infill_density are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
+                'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
                 { slicerType, slicerPath });
             }
             // CuraEngine CLI args are different, often requiring -s for settings