How do I install the Moonraker skill?

Run npx skillmds@latest add dvcrn/moonraker in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Moonraker safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Moonraker?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Moonraker free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Moonraker?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Moonraker by dvcrn — Agent Skill

Name: Moonraker
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Control your 3D printer via the Moonraker REST API.

Host: http://$MOONRAKER_HOST:7125
Helper script: {baseDir}/moonraker.sh

Quick Commands (via moonraker.sh)

moonraker.sh status   # print progress, temps, state
moonraker.sh pause    # pause current print
moonraker.sh resume   # resume paused print
moonraker.sh cancel   # cancel current print
moonraker.sh estop    # EMERGENCY STOP (firmware restart required after)
moonraker.sh files    # list gcode files on printer

API Reference

Base URL: http://$MOONRAKER_HOST:7125

Get Printer State

GET /printer/info

Returns firmware version, Klipper state (ready, error, shutdown, etc.), hostname.

Get Print Stats + Temperatures

GET /printer/objects/query?print_stats&heater_bed&extruder

Returns:

print_stats.state — standby, printing, paused, complete, error
print_stats.filename — currently loaded file
print_stats.print_duration — seconds elapsed
print_stats.total_duration — total time since start
extruder.temperature / extruder.target — hotend actual/target °C
heater_bed.temperature / heater_bed.target — bed actual/target °C

Pause Print

POST /printer/print/pause

Resume Print

POST /printer/print/resume

Cancel Print

POST /printer/print/cancel

Emergency Stop

POST /printer/emergency_stop

⚠️ Immediately halts all motion and heaters. Klipper must be restarted via POST /printer/firmware_restart before printing again.

List GCode Files

GET /server/files/list

Returns array of files in the gcodes directory with name, size, and modified time.

Firmware Restart (after emergency stop)

POST /printer/firmware_restart

Raw curl Examples

# Printer state
curl -s http://$MOONRAKER_HOST:7125/printer/info | jq .

# Temps + print stats
curl -s "http://$MOONRAKER_HOST:7125/printer/objects/query?print_stats&heater_bed&extruder" | jq .

# Pause
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/pause | jq .

# Resume
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/resume | jq .

# Cancel
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/cancel | jq .

# Emergency stop
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/emergency_stop | jq .

# List files
curl -s http://$MOONRAKER_HOST:7125/server/files/list | jq .

Notes

All POST endpoints return {"result": "ok"} on success.
If Klipper is in error/shutdown state, most commands will fail until a firmware restart.
Progress percentage = print_stats.print_duration / print_stats.total_duration * 100 (approximate; more accurate progress available via virtual_sdcard object).
For precise progress: GET /printer/objects/query?virtual_sdcard → virtual_sdcard.progress (0.0–1.0).

---name: moonrakerdescription: Control and monitor a Klipper 3D printer via the Moonraker API — print status, temps, pause, resume, cancel, emergency stop.---Control your 3D printer via the Moonraker REST API.- **Host:** `http://$MOONRAKER_HOST:7125`- **Helper script:** `{baseDir}/moonraker.sh`---## Quick Commands (via moonraker.sh)```bashmoonraker.sh status # print progress, temps, statemoonraker.sh pause # pause current printmoonraker.sh resume # resume paused printmoonraker.sh cancel # cancel current printmoonraker.sh estop # EMERGENCY STOP (firmware restart required after)moonraker.sh files # list gcode files on printer```---## API ReferenceBase URL: `http://$MOONRAKER_HOST:7125`### Get Printer State```GET /printer/info```Returns firmware version, Klipper state (`ready`, `error`, `shutdown`, etc.), hostname.### Get Print Stats + Temperatures```GET /printer/objects/query?print_stats&heater_bed&extruder```Returns:- `print_stats.state` — `standby`, `printing`, `paused`, `complete`, `error`- `print_stats.filename` — currently loaded file- `print_stats.print_duration` — seconds elapsed- `print_stats.total_duration` — total time since start- `extruder.temperature` / `extruder.target` — hotend actual/target °C- `heater_bed.temperature` / `heater_bed.target` — bed actual/target °C### Pause Print```POST /printer/print/pause```### Resume Print```POST /printer/print/resume```### Cancel Print```POST /printer/print/cancel```### Emergency Stop```POST /printer/emergency_stop```⚠️ Immediately halts all motion and heaters. Klipper must be restarted via `POST /printer/firmware_restart` before printing again.### List GCode Files```GET /server/files/list```Returns array of files in the `gcodes` directory with name, size, and modified time.### Firmware Restart (after emergency stop)```POST /printer/firmware_restart```---## Raw curl Examples```bash# Printer statecurl -s http://$MOONRAKER_HOST:7125/printer/info | jq .# Temps + print statscurl -s "http://$MOONRAKER_HOST:7125/printer/objects/query?print_stats&heater_bed&extruder" | jq .# Pausecurl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/pause | jq .# Resumecurl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/resume | jq .# Cancelcurl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/cancel | jq .# Emergency stopcurl -s -X POST http://$MOONRAKER_HOST:7125/printer/emergency_stop | jq .# List filescurl -s http://$MOONRAKER_HOST:7125/server/files/list | jq .```---## Notes- All POST endpoints return `{"result": "ok"}` on success.- If Klipper is in error/shutdown state, most commands will fail until a firmware restart.- Progress percentage = `print_stats.print_duration / print_stats.total_duration * 100` (approximate; more accurate progress available via `virtual_sdcard` object).- For precise progress: `GET /printer/objects/query?virtual_sdcard` → `virtual_sdcard.progress` (0.0–1.0).

Frequently asked questions

Moonraker