Job tools (MCP)
Generated content. This page is produced by
cargo run --bin gen_docs(src-tauri/src/bin/gen_docs/) reading the livermcp::ToolRouterthis crate's MCP server actually registers (McpServer::tool_router_*insrc-tauri/src/mcp/), viaToolRouter::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
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | yes | Path to the G-code file on the machine's SD card, e.g. "/job.nc". |
start_index | integer | no | Line 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.