MCP tools
Cubicle 1.0.0 · 15 toolscreate_computer 7 inputsCreate a computer. Creates a cloud computer (a Linux microVM on Vercel Sandbox: Ubuntu, Node 24, Python 3.14, git, gh, Claude Code, Codex, OpenCode) and starts its first session for the minutes you choose. Optionally clones a public Git repo into ~/<repo>. Returns the computer id, a computer token (shown once), preview URLs for its ports and the clone run. Free: small, up to 10 minutes, 2 a day per IP. A wallet's API key adds a one-time 30-minute trial; after that credits pay 1-4 per minute. A session runs at most 2 hours and must fit the daily compute budget (see pricing); past it the call fails with nothing charged.
start_computer 6 inputsStart a stopped computer. Starts a new session on a stopped computer, with its files restored from the last session. Paid up front by the minute like create_computer.
extend_computer 4 inputsAdd time. Adds minutes to a running session (trial or credits; free sessions cannot be extended). One session lasts at most 2 hours, and the extra time must fit the daily budget.
stop_computer 2 inputsStop a computer. Stops the running session. Files are saved automatically and restored on the next start. Every whole unused minute goes back: credits to your balance, trial minutes to your trial.
computer_status 2 inputs · read-onlyComputer status. State (running or stopped), seconds left, size, repo, preview URLs, recent runs with exit codes, snapshots and how long stopped files are kept.
list_computers 1 inputs · read-onlyList my computers. Your computers: the wallet's (with an API key) and any you pass as [{ computer, token }]. Also shows the wallet's trial minutes.
run_command 5 inputsRun a shell command. Runs a shell command (bash) on a running computer in the background and returns a run id at once. Read its output with read_logs. Long-running servers (npm run dev) keep running until stopped or the session ends; their ports show as preview URLs. Put secrets in env, not in the command text: Cubicle stores the first 300 characters of the command to list your runs, never env values.
run_agent 8 inputsRun a coding agent. Runs a coding agent CLI non-interactively on a running computer with your own model key: claude (Claude Code, -p), codex (codex exec), opencode (opencode run) or gemini (Gemini CLI). It works in the repo with full permissions inside the microVM and returns a run id; read progress with read_logs. Your key goes to that run's environment only and is never stored; model usage is billed by your provider.
read_logs 4 inputs · read-onlyRead run output. Output (stdout and stderr together) of a run from byte offset "offset", up to 64 KB per call. Returns data, next (the offset to ask for next), done and exitCode. Poll with offset=next every 2 seconds until done. When the computer is stopped it returns the last 4 KB.
stop_run 3 inputsStop a run. Stops a run (SIGTERM to its whole process group), like a dev server or a stuck agent.
read_file 3 inputs · read-onlyRead a file. Reads a file from a running computer (up to 256 KB): text, or base64 for binary files.
snapshot_computer 3 inputsTake a snapshot. Saves a named snapshot of the computer's disk and stops it (unused minutes go back). Restore it later with restore_snapshot. A computer keeps its 3 newest snapshots (1 without a wallet), each for 14 days after last use (1 day without a wallet).
restore_snapshot 3 inputsRestore a snapshot. Rolls a stopped computer back to one of its snapshots; the next start boots from it.
delete_computer 3 inputsDelete a computer. Stops and deletes a computer with all its files and snapshots, for good. Needs confirm: "delete".
pricing 0 inputs · read-onlySizes, prices and limits. Whether computers are available right now, machine sizes and credits per minute, the free tier, the wallet trial, caps, today's compute budget (what is left), how long files are kept and the provider limits.