mcp-3d-printer-server 1.2.26 → 1.2.28

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [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
+
+- Every tool now carries the four MCP tool annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) from one table, `src/tool-annotations.ts`, so clients can tell reads from actions without parsing descriptions. Before, 7 of 45 tools had partial annotations. Destructive means the tool may end or replace something that exists: `cancel_print`, `upload_gcode` (same file name), `camera_snapshot` with `save_path`, `get_slice_settings` (a same-named 3MF replaces the extracted settings file), `save_template`, `counterpart_print_route` with a route, and the pass-through calls `fulu_bambu_network_rpc`, `blender_mcp_call` and `fusion_mcp_call`. Starting a print and heating are marked additive, matching the no-confirmation decision. Annotations are hints for clients; every safety check still applies. A test lists the tools over stdio and fails for any tool without all four.
+
+### Fixed
+
+- Resume a Bambu job that the printer paused itself. A P1S paused by Pause or by a `pause_at_layers` stop reports `print_error` 0300_8013 ("paused by the user" / "paused by the pause command in the file"), and Resume refused it as a print error, so a paused job could only be resumed at the printer. The notice is excused only for Resume, only while the printer reports PAUSE; any other print error still refuses, and starting a job still needs no error. Ported from bambu-printer-mcp.
+- FULU's BambuNetwork agent now receives the client headers FULU's own GUI sends before `net.start` (Bambu Studio 02.05.02.51 on Linux, with a per-install device id kept in the config folder). Bambu's cloud issues the printer-control certificate and creates print tasks for this client; without the headers the agent was an unknown client. `BAMBU_NETWORK_CLIENT_NAME` and `BAMBU_NETWORK_CLIENT_VERSION` override the name and version. Ported from bambu-printer-mcp.
+- Evidence: mocked Bambu MQTT/FTPS boundaries and the fake FULU host only; no printer was contacted.
+
 ## [1.2.26] – 2026-11-04
 
 ### Changed

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

@@ -106,6 +106,17 @@ export type BambuNetworkBridgeStatus = {
 export declare function bambuNetworkCertDir(configDir: string, env?: NodeJS.ProcessEnv): string;
 export declare function prepareBambuNetworkCertDir(configDir: string, env?: NodeJS.ProcessEnv): string;
 export declare function defaultBambuNetworkConfigDir(): string;
+/**
+ * The client identity FULU's GUI gives the plug-in before agent start
+ * (GUI_App::init_http_extra_header). Through the Linux bridge FULU presents
+ * itself as Bambu Studio at the version its plug-in ABI belongs to
+ * (PJarczakLinuxBridgeConfig.cpp forced_client_version, "02.05.02.51").
+ * Bambu's cloud issues the printer-control certificate and creates print
+ * tasks for this client, so an agent started without it is an unknown client.
+ * The device id is kept in the config folder so it stays the same per install.
+ * Ported from bambu-printer-mcp src/bambu-network-bridge.ts.
+ */
+export declare function bambuNetworkClientHeaders(configDir: string, env?: NodeJS.ProcessEnv): Record<string, string>;
 export declare class BambuNetworkBridge {
     private child?;
     private commandLine?;

package/dist/bambu-network-bridge.js

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -89,6 +89,41 @@ function trimEnv(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : undefined;
 }
+/**
+ * The client identity FULU's GUI gives the plug-in before agent start
+ * (GUI_App::init_http_extra_header). Through the Linux bridge FULU presents
+ * itself as Bambu Studio at the version its plug-in ABI belongs to
+ * (PJarczakLinuxBridgeConfig.cpp forced_client_version, "02.05.02.51").
+ * Bambu's cloud issues the printer-control certificate and creates print
+ * tasks for this client, so an agent started without it is an unknown client.
+ * The device id is kept in the config folder so it stays the same per install.
+ * Ported from bambu-printer-mcp src/bambu-network-bridge.ts.
+ */
+export function bambuNetworkClientHeaders(configDir, env = process.env) {
+    const idFile = path.join(configDir, "client-device-id");
+    let deviceId = "";
+    try {
+        deviceId = fs.readFileSync(idFile, "utf8").trim();
+    }
+    catch { /* first start */ }
+    if (!deviceId) {
+        deviceId = randomUUID();
+        try {
+            fs.mkdirSync(configDir, { recursive: true });
+            fs.writeFileSync(idFile, `${deviceId}\n`, { mode: 0o600 });
+        }
+        catch { /* still send this run's id */ }
+    }
+    return {
+        "X-BBL-Client-Type": "slicer",
+        "X-BBL-Client-Name": trimEnv(env.BAMBU_NETWORK_CLIENT_NAME) ?? "BambuStudio",
+        "X-BBL-Client-Version": trimEnv(env.BAMBU_NETWORK_CLIENT_VERSION) ?? "02.05.02.51",
+        "X-BBL-OS-Type": "linux",
+        "X-BBL-OS-Version": os.release(),
+        "X-BBL-Device-ID": deviceId,
+        "X-BBL-Language": "en",
+    };
+}
 function fileExists(filePath) {
     try {
         return fs.existsSync(filePath);
@@ -350,6 +385,8 @@ export class BambuNetworkBridge {
         // plug-in verifies a LAN printer with printer.cer from this folder, and
         // FULU's host crashes on connect_printer when no folder was ever set.
         const certificates = await withAgent("net.set_cert_file", { folder: certDir, filename: "slicer_base64.cer" }, false);
+        // FULU's GUI order: set_cert_file, then the client headers, then start.
+        await withAgent("net.set_extra_http_header", { headers: bambuNetworkClientHeaders(configDir) }, false);
         await withAgent("net.set_country_code", { country_code: countryCode });
         await withAgent("net.start");
         // The plug-in runs callbacks through queue_on_main; FULU's host executes

package/dist/index.js

@@ -17,10 +17,11 @@ 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";
+import { annotateTools } from "./tool-annotations.js";
 import { CAMERA_SNAPSHOT_OUTPUT_SCHEMA, CONTROL_OUTPUT_SCHEMA, FILAMENTS_OUTPUT_SCHEMA, PRINT_PROGRESS_OUTPUT_SCHEMA, PRINTER_INFO_OUTPUT_SCHEMA, } from "./counterpart/contract.js";
 import { SlicerError } from "./slicer/slicer-error.js";
 import { inspectSliceSettings, listTemplateRegistry, resolveTemplatePath, resolveTemplateSlicerProfilePath, saveTemplate, } from "./slicer/templates.js";
@@ -317,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
@@ -347,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) {
@@ -374,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) {
@@ -1104,7 +1130,7 @@ class ThreeDPrinterMCPServer {
         // List available tools
         this.server.setRequestHandler(ListToolsRequestSchema, async () => {
             return {
-                tools: [
+                tools: annotateTools([
                     {
                         name: "get_printer_status",
                         description: "Get the current status of the 3D printer",
@@ -1327,14 +1353,12 @@ class ThreeDPrinterMCPServer {
                         description: "Describe this printer for the counterpart/1 contract: server name and version, printer kind and identity, and which features work (progress, layers, camera, filaments, pause, resume, cancel, print_3mf, G-code), detected from the firmware. Read-only.",
                         inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES } },
                         outputSchema: PRINTER_INFO_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: true, openWorldHint: true },
                     },
                     {
                         name: "counterpart_print_progress",
                         description: "Read the printer's state and current job in the counterpart/1 shape: state, job name, progress (0-100), elapsed and remaining seconds, layers when the firmware reports them, temperatures and problems. job.name matches the jobName that upload_gcode and start_print return. Read-only.",
                         inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES } },
                         outputSchema: PRINT_PROGRESS_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: true, openWorldHint: true },
                     },
                     {
                         name: "camera_snapshot",
@@ -1348,7 +1372,6 @@ class ThreeDPrinterMCPServer {
                             },
                         },
                         outputSchema: CAMERA_SNAPSHOT_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: true, openWorldHint: true },
                     },
                     {
                         name: "get_printer_filaments",
@@ -1362,21 +1385,18 @@ class ThreeDPrinterMCPServer {
                             },
                         },
                         outputSchema: FILAMENTS_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: true, openWorldHint: true },
                     },
                     {
                         name: "pause_print",
                         description: "Pause the current print (Bambu Lab, OctoPrint, Klipper/Moonraker, PrusaLink, Duet M25, Repetier, and Creality printers that run Moonraker). Bambu pauses over the same connection that prints. Pause is never gated.",
                         inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES, ...CONNECTION_PROPERTIES } },
                         outputSchema: CONTROL_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
                     },
                     {
                         name: "resume_print",
                         description: "Resume a paused print. Resume reheats and moves the printer, so it only resumes a job this server instance inspected and started, and only when the printer freshly reports that job paused. Bambu re-reads the job over FTPS (or the plate G-code the printer extracted) and compares its SHA-256, and resumes over the same connection that printed. When the file cannot be re-read, a person confirms through MCP elicitation first (Bambu: only for files Bambu's plug-in placed; a file this server uploaded must re-read). Resume other jobs at the printer.",
                         inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES, ...CONNECTION_PROPERTIES } },
                         outputSchema: CONTROL_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
                     },
                     {
                         name: "set_printer_temperature",
@@ -1815,7 +1835,6 @@ class ThreeDPrinterMCPServer {
                     {
                         name: "inspect_print_file",
                         description: "Inspect an exact private snapshot of a prepared sliced 3MF or textual G-code file and selected plate without contacting a printer. Returns versioned file-only evidence; no printer readiness or permission to dispatch is established. Does not auto-slice.",
-                        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
                         inputSchema: {
                             type: "object",
                             additionalProperties: false,
@@ -2188,7 +2207,7 @@ class ThreeDPrinterMCPServer {
                         },
                         outputSchema: FUSION_EXPORT_OUTPUT_SCHEMA,
                     }
-                ]
+                ])
             };
         });
         // Handle tool calls

package/dist/safety/printer-state.d.ts

@@ -81,6 +81,15 @@ export declare function isHiddenNotice(serial: string, model: string, entry: Hms
 export declare function hiddenHmsNotices(raw: unknown, serial: string, model: string): string[];
 /** Cleared-code keys of reported hidden entries; clearing never removes them, so they are not re-acknowledged. */
 export declare function hiddenHmsKeys(raw: unknown, serial: string, model: string): string[];
+/**
+ * 0300_8013, "Printing was paused by the user" / "paused due to the pause command added to the
+ * printing file": the printer's report of a deliberate pause (a Pause, or a pause_at_layers stop),
+ * which Resume clears. A paused P1S reports it as print_error, so it is not an error for resuming
+ * a paused job. requireIdle is false only for Resume here; starting a job still needs no error.
+ * Ported from bambu-printer-mcp src/safety/printer-state.ts.
+ */
+export declare const PAUSE_NOTICE = 50364435;
+export declare function isPauseNotice(raw: Record<string, any>, requireIdle: boolean): boolean;
 /** Verifies reported configuration, not a physical nozzle/spool inspection. */
 export declare function validatePrinterState(status: any, requirements: PrinterStateRequirements): ValidatedPrinterState;
 /** Manual M104 cannot remap filament slots. Validate the material already at the nozzle. */

package/dist/safety/printer-state.js

@@ -316,6 +316,18 @@ function logHiddenNotices(raw, serial, model) {
         console.error(`Printer ${serial} reports ${hmsLabel(entry.hex)}, which Bambu lists for it without text and never shows as a fault; it does not block operations.`);
     }
 }
+/**
+ * 0300_8013, "Printing was paused by the user" / "paused due to the pause command added to the
+ * printing file": the printer's report of a deliberate pause (a Pause, or a pause_at_layers stop),
+ * which Resume clears. A paused P1S reports it as print_error, so it is not an error for resuming
+ * a paused job. requireIdle is false only for Resume here; starting a job still needs no error.
+ * Ported from bambu-printer-mcp src/safety/printer-state.ts.
+ */
+export const PAUSE_NOTICE = 0x03008013;
+export function isPauseNotice(raw, requireIdle) {
+    const state = typeof raw?.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "";
+    return !requireIdle && state === "PAUSE" && finiteNumber(raw?.print_error) === PAUSE_NOTICE;
+}
 function validateErrors(raw, requireIdle, serial, model) {
     const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
     const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
@@ -323,7 +335,7 @@ function validateErrors(raw, requireIdle, serial, model) {
         throw new Error(`Printer state ${state} is not safely idle.`);
     if (!requireIdle && !["IDLE", "FINISH", "RUNNING", "PAUSE"].includes(state) && !terminal)
         throw new Error(`Printer state ${state} is unknown or failed.`);
-    if (finiteNumber(raw.print_error) !== 0)
+    if (finiteNumber(raw.print_error) !== 0 && !isPauseNotice(raw, requireIdle))
         throw new Error("Printer reports a print error or did not report its error state.");
     if (!Array.isArray(raw.hms))
         throw new Error("Printer HMS error state is missing or malformed.");

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/dist/tool-annotations.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) for every tool.
+ * They are hints for clients, never a safety gate: the shared checks in src/safety/ still apply.
+ *
+ * - readOnlyHint: the tool changes nothing (no file, printer, setting, or external application state).
+ * - destructiveHint: it may overwrite or end something that already exists (a file, a setting, a job,
+ *   an arbitrary remote call). Starting a print and heating are additive: there is no confirmation
+ *   prompt for them (AGENTS.md, maintainer decision 2026-11-03), and the printer runs its own checks.
+ * - idempotentHint: calling it again with the same arguments has no further effect.
+ * - openWorldHint: it reaches outside this server and the local files (a printer, its camera, Bambu's
+ *   network, Blender, or Fusion).
+ */
+export interface ToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+export declare const TOOL_ANNOTATIONS: Readonly<Record<string, ToolAnnotations>>;
+/** Give each listed tool its annotations. tests/tool-annotations.test.mjs fails for a tool without an entry. */
+export declare function annotateTools<T extends {
+    name: string;
+}>(tools: T[]): Array<T & {
+    annotations?: ToolAnnotations;
+}>;

package/dist/tool-annotations.js

@@ -0,0 +1,58 @@
+const read = (openWorldHint) => ({ readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint });
+const write = (destructiveHint, idempotentHint, openWorldHint) => ({ readOnlyHint: false, destructiveHint, idempotentHint, openWorldHint });
+export const TOOL_ANNOTATIONS = {
+    // Printer reads.
+    get_printer_status: read(true),
+    list_printer_files: read(true),
+    counterpart_printer_info: read(true),
+    counterpart_print_progress: read(true),
+    camera_snapshot: write(true, false, true), // save_path writes, and replaces, a file of the caller's choosing
+    camera_frame: read(true),
+    get_printer_filaments: read(true),
+    // Printer actions.
+    upload_gcode: write(true, false, true), // can replace a file of the same name on the printer
+    start_print: write(false, false, true),
+    print_3mf: write(false, false, true),
+    process_and_print_stl: write(false, false, true),
+    cancel_print: write(true, true, true), // ends the job; it cannot be resumed
+    pause_print: write(false, true, true),
+    resume_print: write(false, true, true),
+    set_printer_temperature: write(false, true, true),
+    camera_stream_start: write(false, true, true), // "start or renew" one shared connection
+    camera_stream_stop: write(false, true, true),
+    counterpart_print_route: write(true, true, false), // with route, replaces the saved connection in .env
+    // Local files: each STL edit and slice writes a new output file, so a repeat writes another.
+    extend_stl_base: write(false, false, false),
+    scale_stl: write(false, false, false),
+    rotate_stl: write(false, false, false),
+    translate_stl: write(false, false, false),
+    modify_stl_section: write(false, false, false),
+    merge_vertices: write(false, false, false),
+    center_model: write(false, false, false),
+    lay_flat: write(false, false, false),
+    generate_stl_visualization: write(false, false, false), // writes a new SVG file
+    get_stl_info: read(false),
+    slice_stl: write(false, false, false),
+    slice_with_template: write(false, false, false),
+    list_templates: read(false),
+    save_template: write(true, true, false), // replaces a template of the same name
+    get_slice_settings: write(true, true, false), // extracts a 3MF's settings to a TEMP_DIR path named after the file; a same-named 3MF replaces it
+    confirm_temperatures: read(false),
+    inspect_print_file: read(false),
+    // FULU BambuNetwork.
+    check_fulu_orca_setup: read(true), // run_bridge_probe starts FULU's bridge host
+    fulu_bambu_network_rpc: write(true, false, true), // allow_mutating_methods reaches agent and session setup
+    // Blender and Fusion.
+    blender_mcp_status: read(true),
+    blender_mcp_call: write(true, false, true), // any Blender MCP tool
+    blender_mcp_export_stl: write(false, false, true), // never overwrites; leaves the scene unchanged
+    blender_mcp_edit_model: write(false, false, true),
+    fusion_mcp_status: write(false, true, true), // launch: true opens Fusion
+    fusion_mcp_call: write(true, false, true), // any Fusion tool, execute_code included
+    fusion_mcp_new_design: write(false, false, true),
+    fusion_mcp_export: write(false, false, true), // never overwrites files
+};
+/** Give each listed tool its annotations. tests/tool-annotations.test.mjs fails for a tool without an entry. */
+export function annotateTools(tools) {
+    return tools.map(tool => (TOOL_ANNOTATIONS[tool.name] ? { ...tool, annotations: TOOL_ANNOTATIONS[tool.name] } : tool));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.26",
+    "version": "1.2.28",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",
@@ -39,6 +39,8 @@
         "dist/slicer",
         "dist/stl",
         "dist/test",
+        "dist/tool-annotations.d.ts",
+        "dist/tool-annotations.js",
         "dist/types.d.ts",
         "dist/types.js",
         "dist/ensure-web-crypto.d.ts",

package/server.json

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

package/src/bambu-network-bridge.ts

@@ -1,5 +1,5 @@
 import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -180,6 +180,35 @@ function trimEnv(value: string | undefined): string | undefined {
   return trimmed ? trimmed : undefined;
 }
 
+/**
+ * The client identity FULU's GUI gives the plug-in before agent start
+ * (GUI_App::init_http_extra_header). Through the Linux bridge FULU presents
+ * itself as Bambu Studio at the version its plug-in ABI belongs to
+ * (PJarczakLinuxBridgeConfig.cpp forced_client_version, "02.05.02.51").
+ * Bambu's cloud issues the printer-control certificate and creates print
+ * tasks for this client, so an agent started without it is an unknown client.
+ * The device id is kept in the config folder so it stays the same per install.
+ * Ported from bambu-printer-mcp src/bambu-network-bridge.ts.
+ */
+export function bambuNetworkClientHeaders(configDir: string, env: NodeJS.ProcessEnv = process.env): Record<string, string> {
+  const idFile = path.join(configDir, "client-device-id");
+  let deviceId = "";
+  try { deviceId = fs.readFileSync(idFile, "utf8").trim(); } catch { /* first start */ }
+  if (!deviceId) {
+    deviceId = randomUUID();
+    try { fs.mkdirSync(configDir, { recursive: true }); fs.writeFileSync(idFile, `${deviceId}\n`, { mode: 0o600 }); } catch { /* still send this run's id */ }
+  }
+  return {
+    "X-BBL-Client-Type": "slicer",
+    "X-BBL-Client-Name": trimEnv(env.BAMBU_NETWORK_CLIENT_NAME) ?? "BambuStudio",
+    "X-BBL-Client-Version": trimEnv(env.BAMBU_NETWORK_CLIENT_VERSION) ?? "02.05.02.51",
+    "X-BBL-OS-Type": "linux",
+    "X-BBL-OS-Version": os.release(),
+    "X-BBL-Device-ID": deviceId,
+    "X-BBL-Language": "en",
+  };
+}
+
 function fileExists(filePath: string): boolean {
   try {
     return fs.existsSync(filePath);
@@ -493,6 +522,8 @@ export class BambuNetworkBridge {
     // plug-in verifies a LAN printer with printer.cer from this folder, and
     // FULU's host crashes on connect_printer when no folder was ever set.
     const certificates = await withAgent("net.set_cert_file", { folder: certDir, filename: "slicer_base64.cer" }, false);
+    // FULU's GUI order: set_cert_file, then the client headers, then start.
+    await withAgent("net.set_extra_http_header", { headers: bambuNetworkClientHeaders(configDir) }, false);
     await withAgent("net.set_country_code", { country_code: countryCode });
     await withAgent("net.start");
     // The plug-in runs callbacks through queue_on_main; FULU's host executes

package/src/index.ts

@@ -34,10 +34,11 @@ 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";
+import { annotateTools } from "./tool-annotations.js";
 import {
   CAMERA_SNAPSHOT_OUTPUT_SCHEMA,
   CONTROL_OUTPUT_SCHEMA,
@@ -395,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.",
+  },
 };
 
 /**
@@ -427,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) {
@@ -454,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;
 }
 
@@ -1303,7 +1328,7 @@ class ThreeDPrinterMCPServer {
     // List available tools
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
       return {
-        tools: [
+        tools: annotateTools([
           {
             name: "get_printer_status",
             description: "Get the current status of the 3D printer",
@@ -1526,14 +1551,12 @@ class ThreeDPrinterMCPServer {
             description: "Describe this printer for the counterpart/1 contract: server name and version, printer kind and identity, and which features work (progress, layers, camera, filaments, pause, resume, cancel, print_3mf, G-code), detected from the firmware. Read-only.",
             inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES } },
             outputSchema: PRINTER_INFO_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: true, openWorldHint: true },
           },
           {
             name: "counterpart_print_progress",
             description: "Read the printer's state and current job in the counterpart/1 shape: state, job name, progress (0-100), elapsed and remaining seconds, layers when the firmware reports them, temperatures and problems. job.name matches the jobName that upload_gcode and start_print return. Read-only.",
             inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES } },
             outputSchema: PRINT_PROGRESS_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: true, openWorldHint: true },
           },
           {
             name: "camera_snapshot",
@@ -1547,7 +1570,6 @@ class ThreeDPrinterMCPServer {
               },
             },
             outputSchema: CAMERA_SNAPSHOT_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: true, openWorldHint: true },
           },
           {
             name: "get_printer_filaments",
@@ -1561,21 +1583,18 @@ class ThreeDPrinterMCPServer {
               },
             },
             outputSchema: FILAMENTS_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: true, openWorldHint: true },
           },
           {
             name: "pause_print",
             description: "Pause the current print (Bambu Lab, OctoPrint, Klipper/Moonraker, PrusaLink, Duet M25, Repetier, and Creality printers that run Moonraker). Bambu pauses over the same connection that prints. Pause is never gated.",
             inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES, ...CONNECTION_PROPERTIES } },
             outputSchema: CONTROL_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
           },
           {
             name: "resume_print",
             description: "Resume a paused print. Resume reheats and moves the printer, so it only resumes a job this server instance inspected and started, and only when the printer freshly reports that job paused. Bambu re-reads the job over FTPS (or the plate G-code the printer extracted) and compares its SHA-256, and resumes over the same connection that printed. When the file cannot be re-read, a person confirms through MCP elicitation first (Bambu: only for files Bambu's plug-in placed; a file this server uploaded must re-read). Resume other jobs at the printer.",
             inputSchema: { type: "object", properties: { ...PRINTER_TARGET_PROPERTIES, ...CONNECTION_PROPERTIES } },
             outputSchema: CONTROL_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
           },
           {
             name: "set_printer_temperature",
@@ -2016,7 +2035,6 @@ class ThreeDPrinterMCPServer {
           {
             name: "inspect_print_file",
             description: "Inspect an exact private snapshot of a prepared sliced 3MF or textual G-code file and selected plate without contacting a printer. Returns versioned file-only evidence; no printer readiness or permission to dispatch is established. Does not auto-slice.",
-            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
             inputSchema: {
               type: "object",
               additionalProperties: false,
@@ -2396,7 +2414,7 @@ class ThreeDPrinterMCPServer {
             },
             outputSchema: FUSION_EXPORT_OUTPUT_SCHEMA,
           }
-        ]
+        ])
       };
     });
 

package/src/safety/printer-state.ts

@@ -326,12 +326,24 @@ function logHiddenNotices(raw: Record<string, any>, serial: string, model: strin
   }
 }
 
+/**
+ * 0300_8013, "Printing was paused by the user" / "paused due to the pause command added to the
+ * printing file": the printer's report of a deliberate pause (a Pause, or a pause_at_layers stop),
+ * which Resume clears. A paused P1S reports it as print_error, so it is not an error for resuming
+ * a paused job. requireIdle is false only for Resume here; starting a job still needs no error.
+ * Ported from bambu-printer-mcp src/safety/printer-state.ts.
+ */
+export const PAUSE_NOTICE = 0x03008013;
+export function isPauseNotice(raw: Record<string, any>, requireIdle: boolean): boolean {
+  const state = typeof raw?.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "";
+  return !requireIdle && state === "PAUSE" && finiteNumber(raw?.print_error) === PAUSE_NOTICE;
+}
 function validateErrors(raw: Record<string,any>, requireIdle: boolean, serial: string, model: string) {
   const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
   const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
   if (requireIdle && !["IDLE","FINISH"].includes(state) && !terminal) throw new Error(`Printer state ${state} is not safely idle.`);
   if (!requireIdle && !["IDLE","FINISH","RUNNING","PAUSE"].includes(state) && !terminal) throw new Error(`Printer state ${state} is unknown or failed.`);
-  if (finiteNumber(raw.print_error) !== 0) throw new Error("Printer reports a print error or did not report its error state.");
+  if (finiteNumber(raw.print_error) !== 0 && !isPauseNotice(raw, requireIdle)) throw new Error("Printer reports a print error or did not report its error state.");
   if (!Array.isArray(raw.hms)) throw new Error("Printer HMS error state is missing or malformed.");
   for (const reported of raw.hms) {
     const entry = hmsCode(reported);

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