Skip to main content
Glama
dmikushin

orca-slicer-mcp

by dmikushin

orca-slicer-mcp

An MCP server that drives OrcaSlicer headlessly on a private Xvfb display, so an agent can import a model, slice it, and export G-code without a physical screen.

It exists because OrcaSlicer has no scripting API for slicing profiles the way its GUI does. Rather than click buttons by screen coordinate (fragile across versions and resolutions), this server drives OrcaSlicer through its single-instance IPC channel: a short-lived orca-slicer <arg> process forwards its argument over DBus to the already-running GUI. Model paths load via Plater::load_files; a small source patch adds an orca-cmd:export:<path> command that slices the current plate and writes the G-code straight to a file. No coordinate clicking, no file-chooser scripting.

Requirements

System binaries on PATH:

  • orca-slicer 2.4.2, patched (see "OrcaSlicer patch" below)

  • Xvfb

  • openbox

  • xdotool

  • scrot

Python deps are declared in pyproject.toml (mcp, Pillow).

uv venv .venv
uv pip install --python .venv/bin/python -e .

Related MCP server: Klipper MCP Server

OrcaSlicer patch

The DBus-command tools require a patched OrcaSlicer: patches/orca-mcp.patch adds one IPC command, orca-cmd:export:<path>, that slices the current plate and exports the G-code to <path> with no file dialog. It touches four files (InstanceCheck.{hpp,cpp}, Plater.{hpp,cpp}): a new EVT_EXPORT_GCODE_OTHER_INSTANCE event, its parsing in OtherInstanceMessageHandler::handle_message, and Plater::export_gcode_to(), which reuses the existing slice+export path (priv::export_gcode with FORCE_EXPORT).

Apply it in the AUR PKGBUILD (portable, survives OrcaSlicer updates): add orca-mcp.patch to source=()/sha256sums=() and

prepare() {
  cd "$srcdir/OrcaSlicer-${pkgver}"
  patch -p1 < "$srcdir/orca-mcp.patch"
}

then rebuild with makepkg. The patch applies cleanly with patch -p1 against the v2.4.2 source tree.

Single-instance IPC is only active when app.single_instance is true in ~/.config/OrcaSlicer/OrcaSlicer.conf; start_session sets this automatically before launching. (The --single-instance CLI flag is not used - it is not a valid OrcaSlicer 2.4.x option and is rejected by read_cli() before the IPC code runs.)

Running

.venv/bin/orca-slicer-mcp          # stdio MCP server

Register it with your MCP client, e.g. for Claude Code:

claude mcp add orca-slicer -- /home/USER/forge/orca-slicer-mcp/.venv/bin/orca-slicer-mcp

Tools

Tool

Purpose

start_session(display, width, height)

Launch Xvfb + openbox + OrcaSlicer; enable single-instance IPC; dismiss first-run/crash dialogs. Call first.

stop_session()

Terminate OrcaSlicer, openbox and Xvfb.

session_status()

Report running state and current windows.

screenshot()

Return the current screen as a PNG image.

import_model(path)

Load STL/OBJ/3MF/STEP/AMF/SVG into the running instance via single-instance IPC (Plater::load_files).

export_gcode(path)

Slice the current plate and export G-code to path via orca-cmd:export: (one IPC command); returns a header summary.

process_model(stl, gcode)

Convenience: import + export.

print_gcode(gcode, start=True)

Ship a local G-code to the Creality printer and start it (see Printing).

screenshot / click / type_text / press_key / zoom

Low-level primitives for dialogs not yet covered by the high-level tools.

Printing (Creality K1 Max)

print_gcode(gcode_path, start=True) closes the loop: it takes a G-code file this server just exported and gets it printing without you walking to the machine.

The printer's own web UI does expose starting a print, but only as a right-click/tap context-menu item per file — easy to miss and awkward on a phone. This tool drives the exact same two web actions programmatically:

  1. uploadPOST /upload/<name> (multipart, field file), and

  2. start — a WebSocket set on /wsapi with opGcodeFile: "printprt:<gcode_dir>/<name>".

It reaches the Creality web UI through the docker container that serves it, bypassing the public oauth2-proxy gate — the local side only runs scp and ssh <host>; the HTTP upload and WebSocket start execute on the docker host (see creality_print_remote.py), the only machine on the printer's LAN.

Configuration (environment variables):

Variable

Default

Meaning

CREALITY_SSH_HOST

t580

SSH alias of the host running the Creality docker stack.

CREALITY_PROXY_CONTAINER

creality-proxy

Docker container serving the web UI; talked to directly, bypassing oauth2-proxy.

CREALITY_GCODE_DIR

/usr/data/printer_data/gcodes

Upload directory on the printer, used to build the printprt path.

Requires on the docker host: docker, curl, and Python with websocket-client. Pass start=False to stage a file without printing.

Why each moving part exists (hard-won lessons)

These are baked into session.py; do not "simplify" them away:

  • A window manager is mandatory. Without one there is no _NET_ACTIVE_WINDOW; focus and window management silently misbehave. openbox is launched with a bundled openbox-rc.xml that makes every window undecorated and maximized.

  • Commands travel over single-instance IPC, not the CLI action API. A second orca-slicer <arg> process passes CLI validation (the arg is a plain positional, not an option), reaches instance_check, and — because app.single_instance is enabled — forwards the whole command line over DBus to the running instance, then exits. --single-instance must not be passed: it is not a valid 2.4.x option and read_cli() rejects it before instance_check runs, so the sender would error out or spawn a second GUI.

  • app.single_instance must be true before launch. It lives nested under the "app" object in OrcaSlicer.conf (not at the top level); start() sets it and OrcaSlicer preserves it across runs.

  • Export completion is detected by the G-code file on disk, not by any GUI signal: export_gcode polls until the file stops growing across several samples (so a mid-write stall cannot yield a truncated read).

  • Dialogs block the main window. The first-run SSL-certificate dialog, the update-check dialog, and — after any unclean exit — the crash "Restore" dialog all prevent the main window from being created. start() interleaves dismissing them with waiting for the main window, in one loop.

  • The main window's title varies ("Unnamed Window", "*Untitled", a project name), so it is detected by size (>=90% of screen width), not by title.

  • Every xdotool/scrot call has a timeout. A single blocked call (e.g. if the X server dies) would otherwise freeze every polling loop.

  • Long-lived processes are owned by the server. They are spawned with start_new_session=True and held by the OrcaSession object; launching them from an ephemeral shell that then exits would kill them.

Testing

.venv/bin/python test_e2e.py

Runs the full import -> export against a sample STL on a fresh Xvfb and asserts a non-trivial G-code is produced.

Available Tools

12 tools
clickA

Click at absolute screen coordinates (button 1=left, 3=right).

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
buttonNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior2/5

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

No annotations are provided, so the description carries full burden. It does not disclose prerequisites, side effects, or system requirements for the click action. Insufficient for a simulation tool.

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

Conciseness5/5

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

One concise sentence that is front-loaded and contains no extraneous information. Every word earns its place.

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

Completeness3/5

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

The output schema exists (not shown), which may help, but the description lacks context about coordinate system, bounds, or whether the operation is synchronous. Adequate but not comprehensive.

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

Parameters3/5

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

With 0% schema coverage, the description adds meaning by stating coordinates are absolute and mapping button values (1=left, 3=right). However, it omits the default button value and does not explain button 2.

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

Purpose5/5

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

The description clearly states it clicks at absolute screen coordinates, distinguishing it from keyboard and other input tools. It specifies button numbers, making the purpose unambiguous.

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

Usage Guidelines3/5

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

No explicit guidance on when to use vs siblings, but the tool name and description imply it is for mouse clicking. Lacks exclusions or alternatives.

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

export_gcodeA

Slice the current plate and export G-code to an absolute path.

Sends a single orca-cmd:export:<path> command over the single-instance DBus channel. Inside OrcaSlicer this slices the current plate and writes the G-code straight to (Plater::export_gcode_to), bypassing the file dialog entirely. Completion is detected by the G-code file appearing on disk. Returns a summary parsed from the generated G-code header.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes
timeoutNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4/5.0
Behavior4/5

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

No annotations are provided, so the description carries full burden. It details internal mechanism (Plater::export_gcode_to, DBus channel), completion detection (file appearance), and return value (parsed header summary). This is fairly transparent, though it omits potential side effects like overwriting existing files.

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

Conciseness5/5

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

The description is three sentences, each serving a purpose: action statement, technical mechanism, and outcome. No superfluous content; front-loaded with key verb and resource.

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

Completeness3/5

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

While an output schema exists and the description mentions return value, the timeout parameter is undocumented. Error conditions or prerequisites are not covered, leaving some gaps for a moderate-complexity tool.

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

Parameters2/5

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

Schema description coverage is 0%, and the description only mentions 'path' implicitly (absolute path) but does not explain the 'timeout' parameter or its default of 180. This leaves significant meaning undocumented beyond the schema.

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

Purpose5/5

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

The description clearly states the tool slices the current plate and exports G-code to an absolute path, specifying the verb (slice/export) and resource (current plate, G-code). It distinguishes from siblings like print_gcode which prints instead.

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

Usage Guidelines4/5

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

The description explains the tool bypasses the file dialog and sends a DBus command, providing clear context for use. However, it does not explicitly state when not to use or mention alternatives among siblings.

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

import_modelA

Import a model (STL/OBJ/3MF/STEP/AMF/SVG) into the running instance.

Delivers the file path to the already-running OrcaSlicer over the single-instance DBus channel (orca-slicer <path> with single-instance mode enabled in the app config), which routes it to Plater::load_files - no coordinate clicking. Waits until a top-level window title reflects the loaded model.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.5/5.0
Behavior5/5

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

With no annotations, the description fully discloses behavior: it uses DBus single-instance channel, routes to Plater::load_files, and waits for window title change. It also notes 'no coordinate clicking' to clarify non-interactivity.

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

Conciseness5/5

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

Two concise sentences with zero waste. First sentence states purpose and formats; second sentence explains detailed behavior. Front-loaded and efficient.

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

Completeness5/5

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

Given a single parameter and an output schema, the description provides sufficient context about the import process, waiting behavior, and file path delivery, making it complete for the tool's complexity.

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

Parameters3/5

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

The schema has 1 parameter (path) with 0% coverage, so the description must compensate. It mentions 'file path' but does not specify absolute/relative or format constraints, adding limited meaning beyond the schema.

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

Purpose5/5

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

The description clearly states the verb 'import' and the resource 'model', listing supported formats (STL/OBJ/3MF/STEP/AMF/SVG). It differentiates from sibling tools like 'process_model' by specifying loading into a running instance.

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

Usage Guidelines4/5

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

The description explains the mechanism (DBus single-instance, no clicking) and implies when to use (to load a model file). However, it does not explicitly state when not to use or list alternatives.

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

press_keyA

Send a key or chord in xdotool syntax (e.g. 'ctrl+i', 'Return', 'Escape').

ParametersJSON Schema
NameRequiredDescriptionDefault
keysYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.6/5.0
Behavior4/5

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

With no annotations provided, the description takes full burden. It discloses that the tool expects xdotool syntax and sends a key/chord, which is sufficient for a simple action. No side effects or auth needs are mentioned, but the tool's nature doesn't require extensive disclosure.

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

Conciseness5/5

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

A single, well-structured sentence that front-loads the action and immediately provides syntax and examples, with no wasted words.

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

Completeness5/5

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

For a simple tool with one parameter and no enums, the description is complete. It specifies input format and examples, and the presence of an output schema means return value explanation is not needed.

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

Parameters5/5

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

The schema only provides 'Keys' with no additional info. The description adds critical meaning by specifying xdotool syntax and providing concrete examples, fully compensating for the 0% schema coverage.

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

Purpose5/5

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

The description uses specific verb 'Send' and resource 'key or chord', with examples like 'ctrl+i' and 'Return', clearly distinguishing it from siblings like type_text (for text strings) and click (mouse clicks).

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

Usage Guidelines4/5

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

The description explicitly states xdotool syntax and gives examples, indicating when to use the tool for key presses or chords. It does not explicitly state when not to use it, but the context of sibling tools implies alternatives.

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

process_modelA

Convenience: import a model then slice + export G-code in one call.

ParametersJSON Schema
NameRequiredDescriptionDefault
stl_pathYes
gcode_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior3/5

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

With no annotations, the description bears full burden. It describes the sequence but does not disclose side effects like file overwriting or prerequisites (e.g., active session). Basic behavioral cues are missing.

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

Conciseness5/5

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

Single sentence, front-loaded with the word 'Convenience', no wasted words. Efficient and to the point.

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

Completeness3/5

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

The description explains the basic operation but lacks details on prerequisites (session), output (return value), and potential side effects. Given the tool's role in a workflow, more context is needed.

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

Parameters2/5

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

Schema coverage is 0% and the description adds no explanation about the parameters (stl_path, gcode_path). No constraints, formats, or usage hints are provided.

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

Purpose5/5

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

The description clearly states it is a convenience function that imports a model, slices, and exports G-code in one call. It uses specific verbs and resources, and distinguishes itself from siblings like import_model and export_gcode.

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

Usage Guidelines4/5

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

The description implies it is an alternative to calling import_model and export_gcode separately, but does not explicitly state when to use this tool versus the individual steps. No exclusions are mentioned.

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

screenshotA

Capture the current OrcaSlicer screen and return it as a PNG image.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of disclosing behavioral traits. It states the tool captures and returns a PNG, but it fails to detail what area is captured (full window, specific region), whether any side effects occur, or if it works in all application states. This is insufficient for a tool with zero annotations.

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

Conciseness5/5

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

The description is a single, clear sentence with no unnecessary words. It efficiently captures the essential purpose and output format.

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

Completeness4/5

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

Given the tool has no parameters and is straightforward, the description is mostly complete. However, it lacks details about the exact screen area captured and any potential size or resolution considerations. The absence of an output schema is not fully compensated.

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

Parameters4/5

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

There are no parameters, and the schema coverage is 100%. The description does not need to add parameter information, but it could have explained any implicit inputs. According to the rubric, zero parameters baseline is 4, and the description meets this standard.

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

Purpose5/5

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

The description clearly states that the tool captures the current screen of OrcaSlicer and returns a PNG image. The verb 'capture' and resource 'OrcaSlicer screen' are specific, and the output format is explicitly defined, distinguishing it from sibling tools like click, export_gcode, etc.

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

Usage Guidelines3/5

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

The description implies usage when a screenshot is needed, but it does not provide explicit guidance on when to use this tool versus alternatives, nor does it mention any prerequisites or constraints. The context is clear but lacks exclusions or when-not-to-use advice.

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

session_statusA

Report whether a session is running and list its top-level windows.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It correctly states the tool reports status and lists windows, implying a read-only operation, but does not explicitly confirm non-destructiveness or side-effect-free behavior.

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

Conciseness5/5

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

A single sentence with no wasted words. The purpose is front-loaded: 'Report whether a session is running' immediately conveys the primary function.

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

Completeness4/5

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

The description covers the two key outputs (session status and window list). With an output schema available, the agent can understand the return format. It lacks details like whether the list is filtered or ordered, but it's sufficient for a simple status tool.

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

Parameters4/5

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

There are zero parameters and schema coverage is 100%. The description adds no parameter information because none is needed. This is appropriate.

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

Purpose5/5

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

The description clearly states it reports session status and lists top-level windows. The verb 'report' combined with the resource 'session' gives a specific, unambiguous purpose. It distinguishes itself from sibling tools like start_session and stop_session.

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

Usage Guidelines4/5

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

While no explicit when-to-use or when-not-to-use guidance is given, the context of sibling tools (start_session, stop_session) implies this is for checking state. The description is clear enough for a zero-parameter tool.

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

start_sessionA

Start a private Xvfb display with openbox and launch OrcaSlicer on it.

Must be called before any other tool. Dismisses the first-run SSL and update dialogs. Returns a status string.

ParametersJSON Schema
NameRequiredDescriptionDefault
widthNo
heightNo
displayNo:99

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations, the description carries full burden. It discloses starting a display, launching an application, dismissing dialogs, and returning a status string. It hints at state creation (must be called first) but lacks details on idempotency or resource cleanup. Overall adequate.

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

Conciseness5/5

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

Two concise sentences cover the core action, usage prerequisite, dialog handling, and return value. Every sentence is purposeful with no redundancy.

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

Completeness4/5

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

Given the tool's role as a session initializer and the presence of an output schema, the description covers key aspects: what it does, when to call it, and what it returns. Lacks mention of environment prerequisites or behavior on repeated calls, but sufficient for most use cases.

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

Parameters2/5

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

The description adds no explanation of the parameters (width, height, display), despite 0% schema description coverage. The parameters are self-explanatory, but the tool definition does not help the agent understand how to configure them beyond defaults.

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

Purpose5/5

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

The description clearly states the tool's purpose: starting a private Xvfb display with openbox and launching OrcaSlicer. It uses a specific verb-resource combination and distinguishes itself from siblings by indicating it must be called before any other tool.

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

Usage Guidelines4/5

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

The description explicitly states the tool must be called before any other tool, providing clear when-to-use guidance. It does not list explicit when-not-to-use scenarios or alternatives, but the context implies it is the initial setup step.

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

stop_sessionA

Terminate OrcaSlicer, openbox and Xvfb, freeing the display.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries full burden. It discloses the destructive behavior (terminating processes) and what is freed (display). It is clear and sufficient.

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

Conciseness5/5

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

The description is a single, concise sentence with no wasted words. It is front-loaded and gets straight to the point.

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

Completeness4/5

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

Given the simple action and the presence of an output schema, the description adequately covers the tool's behavior. It might be improved by mentioning return value handling, but the output schema presumably addresses that.

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

Parameters4/5

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

The tool has zero parameters, and the schema coverage is 100%. According to the rubric, a baseline of 4 is appropriate. The description adds context about what is terminated but does not need to explain parameters.

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

Purpose5/5

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

The description clearly states the tool terminates three specific processes (OrcaSlicer, openbox, Xvfb) and frees the display, using a specific verb and resource. This distinguishes it from sibling tools like start_session and session_status.

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

Usage Guidelines3/5

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

The description implies the tool is used to end a session by terminating processes, but it does not explicitly state when to use it vs alternatives or provide any prerequisites or conditions.

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

type_textC

Type literal text into the focused widget.

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

Without annotations, the description should disclose behaviors like whether it simulates keystrokes, handles special characters, or works only on certain widgets. It omits these details, leaving the agent to assume basic text insertion.

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

Conciseness4/5

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

The description is concise with one sentence, but it lacks structure such as parameter listing or usage hints. It is appropriately sized for a simple tool but could be more informative.

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

Completeness3/5

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

For a simple one-parameter tool with an output schema, the description covers the basic action but does not address scenarios like missing focus or handling of newlines. It is adequate but leaves potential questions unanswered.

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

Parameters3/5

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

The parameter 'text' is self-explanatory from its name, but the description only repeats 'literal text' without adding format constraints or examples. Given zero schema coverage, the description provides minimal added value beyond the parameter name.

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

Purpose4/5

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

The description clearly states the action ('Type literal text') and the target ('focused widget'), making the tool's purpose understandable. However, it could elaborate on what constitutes a 'widget' (e.g., any UI input field) to improve clarity.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives like 'press_key' or 'click'. The description does not mention prerequisites (e.g., widget must be focused) or cases where other tools are more appropriate.

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

zoomC

Zoom the 3D view. Positive steps zoom in, negative out, over (x,y).

When x/y are left at -1 the screen centre of the active session is used.

ParametersJSON Schema
NameRequiredDescriptionDefault
xNo
yNo
stepsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

With no annotations, the description carries full burden. It discloses zoom direction and center behavior, but omits side effects, limits, or whether the view is permanently changed.

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

Conciseness4/5

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

Two sentences with front-loaded main purpose. Efficient but could be more structured, e.g., listing parameters explicitly.

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

Completeness3/5

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

Output schema exists, so return value not needed. Parameter count is low, but description lacks context on when zoom is appropriate and what 'active session' means, leaving gaps for a new user.

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

Parameters3/5

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

Schema description coverage is 0%, so description adds meaning: steps direction and default x/y behavior. However, x and y semantics (likely coordinates for zoom center) are vague, and steps lacks scaling context.

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

Purpose4/5

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

The description clearly states the tool zooms the 3D view and explains the direction of steps (positive in, negative out). It distinguishes from sibling tools like click or import_model, but lacks specificity about the 3D context.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. The description only explains default behavior for x/y coordinates, not when to choose zoom over other view-manipulation tools.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 12 tool updatesv0.1.0
    • First observedclick
    • First observedexport_gcode
    • First observedimport_model
    • First observedpress_key
    • First observedprint_gcode
    • First observedprocess_model
    • First observedscreenshot
    • First observedsession_status
    • First observedstart_session
    • First observedstop_session
    • First observedtype_text
    • First observedzoom

TDQS

A3.8/5.0

Scored across 12 tools

Disambiguation5/5

Each tool has a distinct purpose: UI actions (click, press_key, type_text), file operations (export_gcode, import_model, process_model), session management (start/stop_session, session_status), printer control (print_gcode), view manipulation (zoom), and capture (screenshot). No overlapping functionality.

Naming Consistency4/5

Most tools follow a verb_noun pattern (e.g., import_model, start_session). However, 'screenshot' is a noun, 'zoom' is a single verb, and 'session_status' uses noun_noun, introducing a few inconsistencies.

Tool Count5/5

12 tools cover the core workflow (session lifecycle, model import, slicing, printing, UI interaction) without being excessive. Each tool justifies its existence for automating OrcaSlicer.

Completeness4/5

The set covers major workflows but lacks direct tools for model editing (e.g., scale, rotate) and printer status. However, UI tools like click and press_key can compensate, and the core slice-and-print path is complete.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers