Ugs Mcp
Connects Claude to CNC machines through Universal GCode Sender's Pendant REST API. Exposes connection management, machine status queries, jogging, homing, and G-code file execution. Every motion command requires a two-step token confirmation: Claude generates a server-side UUID token shown in the preview, you read it back to authorize movement. Also includes G-code inspection tools for translating commands to English, safety checks, cycle time estimates, and tool lists. Built for GRBL machines with UGS 2.x. Useful when you want conversational CNC control without writing REST calls yourself, but need hardware to stay locked down unless you explicitly confirm each movement.
- GitHub stars
- 1
- tools
- 19
- transport
- STDIO
- env vars
- 4
- last updated
- Jun 5, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
ugs_connect
No parameter schema in public metadata yet.
ugs_disconnect
No parameter schema in public metadata yet.
ugs_troubleshoot_connection
No parameter schema in public metadata yet.
ugs_get_status
No parameter schema in public metadata yet.
ugs_get_job_status
No parameter schema in public metadata yet.
ugs_run_file
No parameter schema in public metadata yet.
ugs_pause_job
No parameter schema in public metadata yet.
ugs_cancel_job
No parameter schema in public metadata yet.
ugs_jog
No parameter schema in public metadata yet.
ugs_home
No parameter schema in public metadata yet.
ugs_return_to_zero
No parameter schema in public metadata yet.
ugs_set_work_zero
No parameter schema in public metadata yet.
gcode_safety_check
No parameter schema in public metadata yet.
gcode_estimate_time
No parameter schema in public metadata yet.
gcode_translate
No parameter schema in public metadata yet.
gcode_list_tools
No parameter schema in public metadata yet.
gcode_save_macro
No parameter schema in public metadata yet.
gcode_list_macros
No parameter schema in public metadata yet.
gcode_run_macro
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
UGS_HOSTUGS Pendant host address
UGS_PORTUGS Pendant port (default: 8080)
MACROS_DIRDirectory for saved G-code macros
RAPID_SPEED_MM_MINRapid speed in mm/min used for return-to-zero (default: 5000)
Readme
ugs-mcp
MCP server for controlling CNC machines via Universal GCode Sender.
Lets Claude (or any MCP-compatible AI assistant) connect to a CNC machine, inspect G-code, and issue motion commands — all through the UGS Pendant REST API.
⚠️ STOP. READ THIS FIRST.
This software controls machines that can damage equipment, destroy parts, and injure or kill people.
CNC machines move fast and don't know where your hands are. Before you use this:
Details
- Repository
- github.com/zackpeters93/ugs-mcp
- Package
ugs-mcp- Transport
- STDIO
- Registry
- MCP registry, active