Files 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).

delete_file

Delete a file from the machine's SD card. This permanently removes the file; requires an active connection.

See also: HTTP DELETE /v1/files/*path · gRPC FilesService.DeleteFile

Parameter	Type	Required	Description
path	string	yes	SD-absolute path of the file to delete, e.g. "/job.nc" or "/sub/job.nc".

list_files

List files and directories on the machine's SD card. Read-only; requires an active connection.

See also: HTTP GET /v1/files · gRPC FilesService.ListFiles

Parameter	Type	Required	Description
parent	string	no	SD directory path, e.g. "/" or "/jobs". Defaults to the root.

load_local_toolpath

Parse a local G-code file into a 2D toolpath preview, without running it. Read-only; does not require a machine connection. local_path is read from the machine running this server, not the MCP client.

See also: gRPC FilesService.LoadLocalToolpath

Parameter	Type	Required	Description
local_path	string	yes	Path to a local G-code file to parse, on the machine running this server (not the MCP client).

parse_sd_toolpath

Download a G-code file from the machine's SD card and parse it into a 2D toolpath preview, without running it. Read-only; requires an active connection.

See also: gRPC FilesService.ParseSdToolpath

Parameter	Type	Required	Description
path	string	yes	SD-absolute path of the G-code file to parse, e.g. "/job.nc".

upload_file

Upload a local G-code file to the machine's SD card. Requires an active connection; local_path is read from the machine running this server, not the MCP client.

See also: gRPC FilesService.UploadFile

Parameter	Type	Required	Description
dir	string	no	SD directory to upload into, e.g. "/" or "/jobs".
local_path	string	yes	Path to the local file to upload, on the machine running this server (not the MCP client).