RRS OrcaSlicer MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ORCA_MCP_ROOTS | Yes | Folder list of allowed workspace roots. Under Windows separated by ';', under macOS/Linux by ':'. The first folder is the base for relative file paths. | |
| ORCA_MCP_STATE | Yes | Directory for server state. Must be different for each simultaneously running server. | |
| ORCA_SLICER_BIN | Yes | Path to the installed OrcaSlicer executable (e.g. C:\Program Files\OrcaSlicer\orca-slicer.exe or the AppImage path). | |
| ORCA_MCP_DESKTOP | No | Set to 1 to enable the optional desktop adapter (requires extra dependencies and permissions), 0 to disable it. | 0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| orca_capabilitiesC | Detect installed CLI flags, version/help text and desktop availability. |
| settings_catalogC | Search source-derived setting names, types, labels, enums and ranges (hints). |
| feature_coverageB | Report supported feature families and explicit GUI/API gaps without claiming 100%. |
| native_ui_capabilitiesB | Inspect opt-in native workflow routes and their platform/locale/scene limits. |
| native_scene_readA | Read copied live scene identities/poses/settings and an observed revision for typed GUI edits. Revision is not a full mesh-content hash. Requires the running official bridge plugin; no desktop input occurs. |
| native_transformA | Edit Orca's live native gizmo and verify actual model pose; native Undo is retained. kind move: value is relative millimeters; rotate: relative degrees; scale: target percent on the chosen x/y/z control (Orca's current uniform lock applies). Requires one object/instance, English mm UI and foreground Prepare mainframe. Opt in with ORCA_MCP_DESKTOP=1 and install [desktop] plus system Tesseract. Read native_scene_read and host_bridge_status first. Request IDs are 32 hex. |
| native_historyA | Apply actual Orca undo/redo, 1..20 explicit native history steps, and read the result. Operates on Orca's native history, including manual edits. A workflow may create multiple native steps. No file-level pseudo-undo or automatic retries. Requires the foreground Prepare mainframe and a fresh observed scene revision. |
| native_textA | Use Orca's editable native text/emboss tool: join, cut (engrave) or modifier. Requires one object/instance and foreground English Prepare UI. Saves the unsaved project to backup first. Both paths must be new .3mf files inside configured client/host export roots. Exports and verifies editable native text metadata, height and depth; this is not a faceted text STL substitute. |
| native_calibrationA | Invoke Orca's actual native calibration generator, not independent coupon sweeps. kind temperature (start/end, native fixed 5 C steps), pressure_advance (start/end/step, method tower/line/pattern), max_volumetric_speed, retraction, vfa (start/end/step), cornering (start/end), flow_ratio (test pass_1/pass_2/yolo/ yolo_perfectionist), input_shaping_frequency (x_start/x_end/y_start/y_end), input_shaping_damping (freq_x/freq_y/start/end). Firmware-specific dialogs must match visible expected controls. Back up unsaved project and explicitly replace_scene=true; export generated native 3MF. Never starts a print. |
| native_request_statusB | Read persistent typed native GUI receipt and screenshot/backup paths without repeating input. |
| printer_capabilitiesA | List explicit configured Moonraker/OctoPrint hosts. Configure ORCA_MCP_PRINTERS JSON. |
| printer_statusB | Query actual configured printer/job state without issuing machine commands. |
| printer_uploadA | Upload checksum-bound text G-code without starting it. request_id is 32 hex digits. The provider may replace an existing remote filename. Use a unique name. A repeated request ID returns its receipt; uncertain dispatch is never retried. |
| printer_commandA | Send an explicit physical printer command: start/pause/resume/cancel. start requires an uploaded remote_name; upload never starts a print. Use a fresh 32-hex request_id only for a new authorized action. Reuse it to retrieve acknowledgement after interruption. Query actual state afterward. |
| printer_request_statusC | Retrieve durable printer dispatch receipt without repeating the command. |
| host_bridge_statusB | Inspect the running official-host plugin, session ID and advertised operations. |
| host_plugin_exportC | Write the standalone official-host plugin to a new file for local installation. |
| host_snapshotB | Read live app version, dirty states, selected presets and scene object count. |
| host_model_readC | Read live objects, IDs, parts/instance counts and existing painting flags. |
| host_model_detailA | Read volumes, types, poses, material slots and instances for a known live object ID. Use host_model_read first. Rotations are radians and offsets millimeters. Values are copied on the GUI thread; no native handles leave the callback. |
| host_printer_readB | Read selected printer agent/link/online/firmware if exposed. No credentials or commands. |
| host_slicing_eventsA | Read bounded native pipeline events after a sequence cursor, including dropped-event gaps. Select RRS MCP slicing observer in the process preset slicing_pipeline_plugin first. Compare epoch on reload. Events describe stages, not progress percentage. |
| host_presets_listB | List the running host's loaded process, printer or filament presets. |
| host_preset_readC | Read serialized live preset values, including unsaved edits; redact secret keys. |
| host_preset_updateB | Stage/commit live settings through the official host transaction API. Requires the current session ID and an explicit UUID hex request ID. Changes stay unsaved. Native selection/unsaved-edit dialogs are never suppressed. A timeout is indeterminate: query the receipt instead of repeating the edit. |
| host_project_exportB | Export the live project with unsaved settings as a new 3MF copy. Destination must be in ORCA_MCP_ROOTS and the plugin's export_roots. Does not change the project's saved filename/state. Existing destinations are rejected. |
| host_request_statusB | Read an execution receipt, including after a client timeout or host restart. |
| settings_readB | Read any JSON profile or Orca preferences file with revision SHA256. |
| workspace_listC | List local models, generated artifacts and profile folders within configured roots. |
| artifact_readC | Read a bounded chunk of generated G-code, JSON statistics or logs as text. |
| settings_writeA | Create/merge arbitrary settings, preserving unknown keys; backup existing files. Existing files require current expected_sha256. Keep Orca's serialized value representation, commonly strings and lists of strings. Close Orca before editing live user profiles, or save a new profile and import it in the GUI. |
| profiles_listC | Discover printer, filament and process profiles below a configured root. |
| profile_resolveC | Resolve inherited JSON values; reject cycles and ambiguous parent names. |
| settings_compareC | Compare serialized profiles exactly; report added, removed and changed keys. |
| settings_validateB | Advisory check of source-known types, ranges and enums; not engine validation. |
| profile_exportC | Create a new flattened user profile with inherited values and no parent dependency. |
| project_inspectC | List 3MF members and read JSON/text metadata, including per-object XML. |
| project_settings_writeC | Write project settings to a new 3MF; preserve meshes, painting and unknown members. |
| project_metadata_writeA | Replace existing JSON/XML Metadata in a new 3MF, including object/plate settings. Read the original member first. This is an expert format-level operation; XML/JSON syntax is checked, but OrcaSlicer validates semantics when reopened. |
| mesh_inspectB | Measure an STL/PLY: bounds, volume, triangles, watertightness. Needs [geometry]. |
| mesh_operationA | Offline mesh repair/split/cut/merge/union/difference/intersection/hull/simplify/transform. sources: [{path,sha256}]. action convex_hull for hull. cut takes origin/normal XYZ vectors and optional cap (true); simplify takes face_count; transform takes a 4x4 column-vector affine matrix. Inputs STL/PLY, outputs new STL files in a new directory with measured result/checkpoint. Requires [geometry]. STL units assumed millimeters. Reimport output into Orca; settings and facet painting do not transfer. |
| calibration_series_createA | Create resumable temperature/flow_ratio/pressure_advance/max_volumetric_speed coupons. Uses the supplied calibration model in a 3MF, one constant-setting project per value. Preserves other filament slots. PA is explicitly enabled for its slot. This does not generate Orca's native towers, select a winner or start a print. Use batch_slice on the completed paths. Inspect/measure coupons before applying a selected result to a profile with the existing settings/profile tools. |
| project_geometry_readC | Inspect mesh IDs, component references and build transforms in a 3MF member. |
| project_transform_writeA | Set a build/component affine transform in a NEW 3MF; original and painting survive. Matrix uses 3MF's 12-number row-vector order: 3x3 linear part then XYZ translation in model units. Component changes affect ALL referencing instances. Read project_geometry_read and source SHA first. Requires reslicing/reopening. |
| project_painting_readC | Read triangle IDs, indices and support/seam/material/fuzzy paint trees. |
| project_painting_writeA | Paint explicit triangles in a NEW 3MF, preserving other channels and topology. kind: support/seam/material/fuzzy_skin. Each change has triangle (0-based) and either state (0 none, 1 enforcer, 2 blocker; material 1..16 filament slot), or mask (validated Orca hex subdivision tree; null clears channel). Inspect member/object IDs and SHA first. Affects all uses of that mesh. |
| project_objects_readC | Read objects, part IDs, plates and instance assignments as structured settings. |
| project_target_settings_writeA | Set object/part or plate print settings in a new 3MF using stored IDs. target is object or plate. Values are Orca's serialized strings. Geometry, identity and cached G-code references are protected. Reslicing is required. |
| gcode_analyzeB | Summarize declared time/material/layers, selected settings and temperature commands. |
| cli_runA | Queue any advertised long CLI flags with ordered raw argv (no shell). Supports all CLI actions in the installed version, not GUI-only functions. Inputs, profiles and outputs should use absolute paths. This trusted local tool runs Orca with your OS privileges; file-root checks do not sandbox CLI. |
| slice_projectA | Slice 3MF/STL/STEP inputs using the installed engine and supplied profiles. Plate 0 selects all plates. Use a self-contained Orca 3MF or supply complete printer/process/filament JSON; the bridge does not guess printer settings. Reusing an optional idempotency_key returns the saved job, even after a restart. Changed input/profile bytes or parameters conflict. Use a new key for an intentional retry. Queued jobs verify input/profile hashes again. |
| batch_sliceA | Slice up to 64 inputs independently with durable, retry-safe batch identity. Reusing a key with unchanged inputs returns existing jobs; changed contents cause a conflict. Each input has its own output folder and sliced 3MF. Interrupted/failed work is never silently repeated; use a new key to retry it. |
| batch_statusB | Aggregate durable batch status and per-input job IDs after reconnecting. |
| batch_cancelB | Cancel active/queued work in a batch and keep successful results unchanged. |
| job_statusB | Read durable job state, output files and bounded log tail. |
| job_logA | Read saved CLI output from a byte cursor; reuse next_offset on reconnect. Each response is bounded to 100000 bytes; saved logs are capped at 10 MiB. at_end means caught up with the observed bytes, not that slicing finished. |
| job_waitB | Wait up to 30 seconds for a saved job; timeout does not cancel slicing. Returns the durable state; queued/running means call again. Restarted jobs remain interrupted and are never automatically repeated. |
| jobs_listB | List recent persisted jobs, including interrupted work after restarts. |
| job_cancelB | Cancel queued/running work and terminate its process tree. |
| desktop_screenshotC | Inspect foreground OrcaSlicer on the optional local desktop. |
| desktop_focusA | Bring a single existing OrcaSlicer window to the foreground. |
| desktop_launchA | Launch the installed GUI, optionally opening a local project; requires desktop opt-in. |
| desktop_actionB | Visual GUI interaction: click/double_click/right_click/move/drag/scroll/keys/text. Inspect screenshots before/after. Coordinates use the full desktop screenshot. OrcaSlicer must be foreground. Dialogs and permissions may need local handling. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 63 tools
The set contains many similarly purposed tools across domains: host_request_status, native_request_status, printer_request_status, job_status, and batch_status all retrieve status/receipts, while host_model_read, host_model_detail, project_inspect, project_objects_read, and project_geometry_read overlap in reading model/project structure. Descriptions add context, but at 63 tools an agent can easily misselect between host, native, project-file, and desktop paths.
All names use snake_case and consistent domain prefixes such as host_, native_, printer_, settings_, project_, batch_, and job_. There are minor inconsistencies in action placement and plurality, e.g. job_status vs jobs_list, host_presets_list vs host_preset_read, and noun_verb vs verb_noun forms, but the pattern remains readable.
The server exposes 63 tools, far beyond a well-scoped MCP surface. Although the OrcaSlicer domain is broad, the count includes many specialized variants, status/request tools, and overlapping read/write paths that make the set overwhelming rather than proportionate.
Coverage is broad across slicing, host bridge, native GUI operations, printer control, settings/profiles, project/mesh editing, jobs, and desktop automation. Remaining gaps include missing delete/rename operations for profiles or workspace artifacts and limited printer file management, which are mostly workaroundable.