prusactl

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:

• Watch: check state, temperatures, job progress, and the camera (over RTSP with setup --camera, or through Connect).
• Print: upload files, start them, pause, resume, and stop, and (with Connect) queue them.
• Control: heat, home, move, load and unload filament, and level the bed: through Connect at any time, or as G-code while the printer is idle.
• Answer the printer: press the buttons on dialogs shown on its screen, such as runout or errors. Needs Connect.
• Run G-code: any G-code, over the direct connection, while the printer is idle.

It is one Go binary; no browser is needed. 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?

Cancelling one object, reading a dialog, and print history go through Prusa Connect, so those need prusactl login; the rest works directly. So does the camera, once you tell prusactl where it is (see The camera).

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

First remove what prusactl saved: prusactl setup --forget deletes the printer's address and password, and prusactl logout deletes the Prusa Connect session. Then remove the program with brew uninstall prusactl, or by deleting the file. All that's left is a prusactl folder holding an empty lock file, in your config directory (~/Library/Application Support on macOS, ~/.config on Linux, %AppData% on Windows); delete it too if you like.

Quick start

prusactl setup 192.168.1.50    # the printer's address; asks for its PrusaLink password

prusactl status

prusactl setup --camera rtsp://192.168.1.60/live # optional: the camera, no Connect needed prusactl login # optional: Prusa Connect, for remote access, camera, dialogs

The PrusaLink password is on the printer under Settings → Network → PrusaLink. PrusaLink is on by default; if someone turned it off, turn it back on there.

setup saves one printer for the direct route; running it again for another printer replaces the first (it says so). With several printers, set up the one you use most and reach the others through Prusa Connect.

Connect an AI agent

Claude Code:

claude mcp add --scope user prusa -- "$(command -v prusactl)" mcp

$(command -v prusactl) saves the full path, so it works even when the app isn't started from a terminal that has your PATH.

Any other MCP client: add prusactl as a stdio server, using the path that command -v prusactl prints (where prusactl on Windows):

{

"mcpServers": { "prusa": { "command": "/opt/homebrew/bin/prusactl", "args": ["mcp"] } } }

The MCP bundle: each release includes prusactl.mcpb, which carries its own copy of prusactl for macOS, Linux x86-64, and Windows x86-64. Open it in an app that installs MCPB extensions, such as Claude Desktop (double-click the file), and enter the printer's address and PrusaLink password when asked. The bundle covers the direct route; Prusa Connect sign-in still needs prusactl login from an installed copy.

prusactl is also listed in the MCP Registry as io.github.trevin-lee/prusactl, for clients that browse it.

A skill for Claude Code: skills/prusactl/SKILL.md teaches an agent the workflows (checking status, starting a print after looking at the plate, watching for failures, updating firmware) and the hazards. Copy the folder to ~/.claude/skills/prusactl/ (or a project's .claude/skills/) to use it.

How it works

flowchart LR

agent["AI agent (Claude Code, …)"] -- "MCP over stdio" --> px["prusactl"] you["You, in a terminal"] --> px px -- "local network PrusaLink API" --> printer["Your printer"] px -. "internet, optional" .-> connect["Prusa Connect"] connect <-.-> printer px --- keychain[("OS keychain")]

prusactl reaches the printer two ways, and each tool picks one:

The direct route is used whenever the printer answers. Otherwise, or for Connect-only features, the tool goes through Connect. Results from tools that can take either route say which one they used (via); the rest always use the route their feature needs.

The camera

The Buddy3D camera is not part of the printer. It is a separate Wi-Fi device that talks to Prusa Connect on its own and serves a video stream at rtsp:// /live; the printer's PrusaLink has no camera endpoint (Buddy firmware serves none), so a direct connection alone can't show it. Tell prusactl where the camera is and it grabs one frame at a time with ffmpeg, which must be on your PATH:

prusactl setup --camera rtsp://192.168.1.60/live   # find the camera's IP in your router

prusactl camera snapshot.jpg

A snapshot comes from the first source that works: the printer's own /api/v1/cameras/snap, if its PrusaLink has one (other PrusaLink builds do); the saved RTSP address; then Prusa Connect. via: "direct" limits it to the first two, via: "connect" to Connect. PRUSACTL_CAMERA_URL overrides the saved address. An address with a user or password is refused: ffmpeg would get the password on its command line, where any local user can read it with ps, and it would sit in plain text in the config. The Buddy3D camera takes none.

Only plain rtsp:// addresses are accepted. rtsps:// is refused on purpose: FFmpeg 7.1.5 completes the TLS handshake with a self-signed certificate and sends the camera's credentials even with -tls_verify 1 and -ca_file, because its RTSP code never hands those options to the TLS layer. The Buddy3D camera serves plain RTSP, so this costs nothing there. Residual risk: plain RTSP sends the video unencrypted, so anyone on your network can watch it; keep the camera off untrusted networks.

Signing in to Prusa Connect

prusactl login asks for your Prusa Account email and password, plus a 2FA code if your account has one. It fills in Prusa's own login page over HTTPS the same way a browser would. It then trades the resulting code for tokens, using the OAuth + PKCE flow of the Connect web app.

Letting an AI agent sign in for you. prusactl login --manual never sees a password. It prints a Prusa Account link on a line of its own (and opens it in your browser unless you pass --no-open), then reads one line from stdin: the address the browser ends on after you approve, which looks like https://connect.prusa3d.com/login/auth-callback?code=...&state=... (the bare code= value also works). An agent can drive it; skills/prusactl/SKILL.md says how. There is no loopback mode: Prusa Account rejects a 127.0.0.1 redirect for the Connect client ("Mismatching redirect URI"), so the code can only be read from the address bar. It also relies on Connect's auth-callback page leaving a code alone when its state isn't one the page issued, which is how the page behaves today. If Prusa changes that, the sign-in fails at the token step, and the fix is an update to prusactl.

• Your password is sent only to account.prusa3d.com and is never stored.
• Where tokens are kept: the OS keychain (macOS Keychain, Secret Service, or Windows Credential Manager), under the service prusactl. A machine without one, such as a headless Raspberry Pi, gets secrets.json in prusactl's config directory instead, readable only by you; PRUSACTL_KEYRING=file forces that.
• Staying signed in: tokens refresh on their own. Prusa rotates refresh tokens, so refreshes are coordinated between processes. Several agents can share one session without signing each other out.
• Google or Apple sign-in accounts need a Prusa Account password set before this works.

The printer's PrusaLink password is kept in the same keychain.

MCP tools

| `get_camera_snapshot