mcp-3d-printer-server 1.2.26 → 1.2.27

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [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/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

@@ -21,6 +21,7 @@ import { STLManipulator } 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";
@@ -1104,7 +1105,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 +1328,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 +1347,6 @@ class ThreeDPrinterMCPServer {
                             },
                         },
                         outputSchema: CAMERA_SNAPSHOT_OUTPUT_SCHEMA,
-                        annotations: { readOnlyHint: true, openWorldHint: true },
                     },
                     {
                         name: "get_printer_filaments",
@@ -1362,21 +1360,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 +1810,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 +2182,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/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.27",
     "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.27",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.26",
+      "version": "1.2.27",
       "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

@@ -38,6 +38,7 @@ import { STLManipulator, type BambuSliceOptions, type ProcessOverrides, type Sli
 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,
@@ -1303,7 +1304,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 +1527,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 +1546,6 @@ class ThreeDPrinterMCPServer {
               },
             },
             outputSchema: CAMERA_SNAPSHOT_OUTPUT_SCHEMA,
-            annotations: { readOnlyHint: true, openWorldHint: true },
           },
           {
             name: "get_printer_filaments",
@@ -1561,21 +1559,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 +2011,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 +2390,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);