Luban MCP tools — v4.15.2-mcp-alpha.8

Terse reference for the 65 MCP tools in v4.15.2-mcp-alpha.8.

Start a fresh session with get_stored_state. Read the CNC skills and MCP setup guide for operating rules. Staged jobs require operator approval through the confirmation page; direct tools follow their documented guards.

Status and connection

• get_machine_profile — Machine profile: build volume, per-toolhead work ranges, and kinematics (which element moves per axis).
• get_position — The machine POSITION OF RECORD: the judged machine-frame position with its reliability.
• get_connection_status — Report whether Luban is connected to a machine, and over which channel.
• recover_machine_connection — Recover stopped HTTP heartbeat polling using only the machine session already held by Luban.
• get_mcp_diagnostics — Timing evidence for slow or aborted procedures.

G-code jobs

• validate_gcode — Statically inspect G-code: motion extents, feeds, spindle commands and warnings.
• submit_gcode_job — Stage a G-code job for human confirmation.
• start_gcode_job — Start an approved job: uploads the file to the machine through the same prepare/start path as "Start on Luban" (door interlock applies) and starts it.
• get_job_timing — Where a job's time went, computed from its event log.
• get_gcode_job_status — Report a job state, ending reason, events, results, and live machine progress.
• stop_gcode_job — Stop a running job.
• convert_thread_milling_gcode — Offline conversion of Machining Doctor thread-milling G-code to explicit Snapmaker G0/G1 moves.

Transport and direct motion

• restore_work_frame — Put the controller back in the WORK workspace (G90 then G54 on its own line).
• home — MACHINE home (G28): drives every axis to its limit switches - this is NOT the work origin; moving to work X0 Y0 is the separate goto_work_origin operation.
• goto_work_origin — STAGE a move to the WORK origin: one XY move to work X0 Y0 at the CURRENT Z.
• move_and_capture — ONE vision-driven XY reposition: Z-GATED FIRST (operator ruling 2026-09-21), then move, settle-verify, and capture a position-stamped frame.
• move_z — Request absolute Z motion, executed on the direct path so positions PERSIST.
• traverse_xy — Law-2 TRANSPORT: an absolute XY move, or an ordered series.

Camera and vision

• visual_servo — Use the stored camera calibration to move toward a target pixel and capture a new frame.
• list_cameras — List available capture sources: the configured snapshot URL, or DirectShow video devices found by ffmpeg.
• capture_frame — Capture one frame from the workshop camera (configstore: mcpCameraUrl for an HTTP snapshot source, else ffmpeg with mcpCameraDevice/mcpFfmpegPath).
• get_frame — Return a frame that was captured earlier, by frame_id.
• preview_cameras — Show what each attached camera SEES, one frame per camera, so the right one can be identified before it is selected.
• select_camera — Choose which camera every capture uses from here on.
• set_tool_region — Update the expectedToolRegion that every capture reports: the fractional box where the endmill images (fixed camera-to-spindle geometry).
• track_feature — Template-match a patch between two cached frames.
• query_firmware_configuration — Read the configuration currently used by the firmware with M503 S (not necessarily EEPROM values).
• query_firmware_position — Ask the firmware directly for its position report (M114) and return the RAW controller response alongside the heartbeat-derived view.

Camera model

• set_camera_calibration — Persist a pixel-to-machine calibration, keyed by the machine Y it was derived at (the SM2 platform travels in Y, so a mapping is only valid at that Y).
• get_camera_calibration — Fetch calibrations: by id, nearest to a machine Y (within tolerance), or all.
• delete_camera_calibration — Delete one stored calibration by id.
• get_camera_model — The current camera model and whether it may still be used.
• set_camera_model — Store a camera model solved from a bootstrap frame set (scripts/camera_bootstrap.py).
• plan_view_pose — Where must the TOOLHEAD go to see this machine point? Read-only.
• camera_bootstrap — Stage the camera pre-configuration for human approval.
• verify_camera_model — Check the stored camera model against a target whose machine coordinates are known, at the CURRENT toolhead position, and record the residual.

Landmarks

• set_landmark — Persist a named scene landmark (tool height checker, rotary span, tool post...) with its machine-coordinate XY extent and a description.
• set_probe_geometry — Store the jig/tool constants a rotary probe_program may reference as the "axis" namespace.
• delete_landmark — Delete one stored landmark by id or name.
• get_stored_state — Everything already known about this machine and bed in one read-only call.

Probe feed

• get_probe_feed_status — State of the external probe sensor feed (transport mqtt or gpio).
• connect_probe_feed — Connect (or reconnect) to the probe sensor feed using the current settings.
• disconnect_probe_feed — Disconnect from the probe sensor feed and stop reconnecting.
• clear_overtravel_alarm — Clear the latched safety alarm (overtravel OR crash - a contact sensor firing during motion that expected no contact) that is blocking all motion.

Tool setter and tool change

• set_tool_setter_config — Store the tool setter reference: its centre in MACHINE coordinates, the machine Z at which a known bit triggers it, that bit's length, and the longest bit in use.
• get_tool_setter_config — The stored tool setter reference (centre, trigger Z, bit lengths, tool-change park position) and the last two measurements.
• run_tool_setter — Stage a tool height measurement against the tool setter for human confirmation.
• goto_tool_change_position — Stage the move to the operator-set tool-change park position.
• apply_tool_length_offset — After a tool change: shift the CURRENT work origin Z by the measured length difference between the last two tool setter measurements.

Touch-probe procedures

• probe_point — Stage a touch-probe point measurement for human confirmation.
• probe_vector — Stage a touch-probe march along an ARBITRARY direction for human confirmation.
• probe_sequence — Stage a whole measurement CIRCUIT as ONE operator approval.
• probe_circle — Stage an N-point circle measurement of a roughly-round vertical feature for human confirmation.
• probe_surface_path — Stage a TOP-SURFACE FLATNESS scan along a straight line for human confirmation.
• probe_surface_grid — Stage a TOP-SURFACE HEIGHT MAP for human confirmation.
• survey_bed — Stage a whole-bed camera survey for human confirmation.
• probe_stock_outline — Stage a probe circuit to find a block top, outline, and centre from an estimated location.
• probe_wall_follow — Stage ONE approved procedure that follows a VERTICAL wall.
• probe_corner — Stage ONE approved procedure that measures the RADIUS of an internal corner between two walls earlier marches have fitted.
• probe_trace_perimeter — Stage ONE approved procedure that traces the whole INTERNAL PERIMETER of a pocket of UNKNOWN shape from one point known to be inside it (operator spec 2026-09-22).
• probe_program — Stage a COMPOSITE probing program for ONE human approval.

CAM probing programs

• run_probing_gcode — Stage a CAM probing program for one operator approval and return an inspection report.
• get_inspection_report — Render the inspection report of a finished (or aborted) run_probing_gcode job in another format.

Workspaces and origins

• set_workspace_origin — Stage a HUMAN-GATED origin write to an explicitly named G54..G59.3 workspace.
• select_workspace — Stage a HUMAN-GATED selection of an existing G54..G59.3 workspace without changing any stored origin.

MCP setup guide · CNC skills