prusactl MCP server

prusactl

Hand your Prusa 3D printer to an AI agent. An MCP server that talks to the printer directly on your network, and through Prusa Connect from anywhere — and a CLI that does everything the agent can.

prusactl mcp gives an agent such as Claude hands on your printer. It can:

queue them.

• Watch: check state, temperatures, job progress, and (with Connect) the camera.
• Print: upload files, start them, pause, resume, and stop, and (with Connect)

through Connect at any time, or as G-code while the printer is idle.

• Control: heat, home, move, load and unload filament, and level the bed:

runout or errors. Needs Connect.

• Answer the printer: press the buttons on dialogs shown on its screen, such as

• Run G-code: any G-code, over the direct connection, while the printer is idle.

It is one Go binary with no browser involved. Setup is two terminal prompts.

Things you can ask

How's the print going? Show me the camera.

Print ~/Downloads/bracket.bgcode.

Preheat for PETG.

Object 3 is spaghetti. Cancel just that one.

The printer is showing a dialog. What does it say?

What did I print this week, and how many failed?

The camera, cancelling one object, reading a dialog, and print history go through Prusa Connect, so those need prusactl login; the rest works directly.

Install

Homebrew (macOS and Linux):

brew install trevin-lee/tap/prusactl

This builds prusactl from source, so Homebrew installs Go first if you don't have it; the build itself takes seconds. Tab completion for bash, zsh, and fish comes with it. Update with brew upgrade prusactl. To remove it, see Uninstall.

Installed prusactl 0.1.3 or earlier? That was a cask. Switch once with

brew uninstall --cask prusactl && brew update && brew install trevin-lee/tap/prusactl.

Your saved printer and Prusa Connect session are kept.

A downloaded binary: get the archive for your system from Releases: macOS (universal), Linux (x86-64, ARM64, ARMv7 such as a Raspberry Pi), or Windows (x86-64, ARM64). checksums.txt lists their SHA-256 sums.

tar -xzf prusactl_*_linux_arm64.tar.gz   # macOS and Linux: unpack the one you downloaded
sudo install prusactl /usr/local/bin/    # or any other folder on your PATH

On Windows, unzip it and put prusactl.exe in a folder on your PATH. The binaries aren't code-signed: if macOS won't open it because it can't verify the developer, run xattr -d com.apple.quarantine /usr/local/bin/prusactl. To update, replace the file with a newer release. prusactl help completion shows how to add Tab completion.

Go:

go install github.com/trevin-lee/prusactl/cmd/prusactl@latest

This puts it in $(go env GOPATH)/bin, which needs to be on your PATH. It needs Go 1.26.6 or newer; recent Go versions fetch that on their own.

Check it worked with prusactl --version.

Uninstall

Shortened. The full README is on GitHub.