Skip to main content

Job tools (MCP)

Generated content. This page is produced by cargo run --bin gen_docs (src-tauri/src/bin/gen_docs/) reading the live rmcp::ToolRouter this crate's MCP server actually registers (McpServer::tool_router_* in src-tauri/src/mcp/), via ToolRouter::list_all(), re-run on every docs-site build. Do not hand-edit it: fix the generator or the source it reads instead.

Each tool below is a thin wrapper over the identical operation the HTTP and gRPC APIs expose: same underlying MaslowService method, same effect on the machine, just a different transport. The See also line under each tool cross-references the other two surfaces, found by matching the tool's name against the real HTTP route table and the compiled proto descriptor (not a hand-maintained mapping, so it can't point at the wrong route).

get_job

Get the state of the current (or most recently run) G-code job: state, progress counters, path. Read-only; poll this instead of subscribing to progress events.

See also: HTTP GET /v1/jobs/current · gRPC JobService.GetJob

No parameters.

get_saved_job

Get the on-disk record of a job interrupted by a disconnect or app restart, if any. Resumable via start_job with the same path and this record's acked count as start_index. Read-only.

See also: gRPC JobService.GetSavedJob

No parameters.

pause_job

Pause the currently streaming G-code job (feed-hold). The machine will physically stop in place.

See also: gRPC JobService.PauseJob

No parameters.

resume_job

Resume a paused G-code job. The machine will physically resume cutting.

See also: gRPC JobService.ResumeJob

No parameters.

start_job

Start streaming a G-code job from the machine's SD card. The machine will physically begin cutting; only safe when get_action_policy reports run as true (belts tensioned and idle).

See also: gRPC JobService.StartJob

ParameterTypeRequiredDescription
pathstringyesPath to the G-code file on the machine's SD card, e.g. "/job.nc".
start_indexintegernoLine index to resume from. Use a saved job's acked count (from get_saved_job) to resume an interrupted job; 0 starts from the beginning.

stop_job

Stop the currently streaming G-code job. The machine will physically stop; the job cannot be resumed from this point without a fresh start_job call.

See also: gRPC JobService.StopJob

No parameters.