{"server":{"name":"desk","version":"1.0.0","mcp":"https://deskdigest.site/api/mcp","protocolVersion":"2025-06-18","transport":"streamable-http (JSON responses, no sessions)"},"tools":[{"name":"create_computer","title":"Create a computer","description":"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.","http":"POST https://deskdigest.site/api/computers/create","inputSchema":{"type":"object","properties":{"repo":{"type":"string","description":"Optional public https Git URL, like https://github.com/vercel/next-learn."},"branch":{"type":"string","description":"Optional branch or tag."},"size":{"type":"string","enum":["small","medium","large"],"description":"Machine size: small (2 vCPU, 4 GB, 1 credit/min), medium (4 vCPU, 8 GB, 2/min), large (8 vCPU, 16 GB, 4/min)."},"minutes":{"type":"integer","description":"Session length, 5-120 (default 30; free sessions up to 10).","minimum":1,"maximum":120},"ports":{"type":"array","items":{"type":"integer"},"description":"Up to 4 ports to expose as public preview URLs (default 3000, 5173, 8080)."},"name":{"type":"string","description":"Optional display name."},"billing":{"type":"string","enum":["auto","trial","credits","free"],"description":"How to pay: auto (default: wallet trial, then credits, then the free tier), trial, credits or free."}},"additionalProperties":false}},{"name":"start_computer","title":"Start a stopped computer","description":"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.","http":"POST https://deskdigest.site/api/computers/start","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"minutes":{"type":"integer","description":"Session length, 5-120 (default 30).","minimum":1,"maximum":120},"size":{"type":"string","enum":["small","medium","large"],"description":"Machine size: small (2 vCPU, 4 GB, 1 credit/min), medium (4 vCPU, 8 GB, 2/min), large (8 vCPU, 16 GB, 4/min)."},"billing":{"type":"string","enum":["auto","trial","credits","free"],"description":"How to pay: auto (default: wallet trial, then credits, then the free tier), trial, credits or free."},"fresh":{"type":"boolean","description":"If the files expired, boot a clean computer instead of failing."}},"required":["computer"],"additionalProperties":false}},{"name":"extend_computer","title":"Add time","description":"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.","http":"POST https://deskdigest.site/api/computers/extend","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"minutes":{"type":"integer","description":"Minutes to add, 1-120 (default 15).","minimum":1,"maximum":120},"billing":{"type":"string","enum":["auto","trial","credits","free"],"description":"How to pay: auto (default: wallet trial, then credits, then the free tier), trial, credits or free."}},"required":["computer"],"additionalProperties":false}},{"name":"stop_computer","title":"Stop a computer","description":"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.","http":"POST https://deskdigest.site/api/computers/stop","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."}},"required":["computer"],"additionalProperties":false}},{"name":"computer_status","title":"Computer status","description":"State (running or stopped), seconds left, size, repo, preview URLs, recent runs with exit codes, snapshots and how long stopped files are kept.","http":"GET https://deskdigest.site/api/computers/status","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."}},"required":["computer"],"additionalProperties":false}},{"name":"list_computers","title":"List my computers","description":"Your computers: the wallet's (with an API key) and any you pass as [{ computer, token }]. Also shows the wallet's trial minutes.","http":"GET https://deskdigest.site/api/computers/list","inputSchema":{"type":"object","properties":{"computers":{"type":"array","description":"Optional [{ computer, token }] for computers made without a key.","items":{"type":"object","properties":{"computer":{"type":"string"},"token":{"type":"string"}}}}},"additionalProperties":false}},{"name":"run_command","title":"Run a shell command","description":"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: Desk stores the first 300 characters of the command to list your runs, never env values.","http":"POST https://deskdigest.site/api/computers/run","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"command":{"type":"string","description":"Shell command, up to 8000 characters, like \"npm install && npm test\"."},"cwd":{"type":"string","description":"Working directory (default: the repo, else ~)."},"env":{"type":"object","description":"Environment variables for this run only, like { \"GH_TOKEN\": \"...\" }. Never stored.","additionalProperties":{"type":"string"}}},"required":["computer","command"],"additionalProperties":false}},{"name":"run_agent","title":"Run a coding agent","description":"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.","http":"POST https://deskdigest.site/api/computers/agent","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"agent":{"type":"string","enum":["claude","codex","opencode","gemini"],"description":"Which CLI (default claude)."},"prompt":{"type":"string","description":"The task, up to 20000 characters."},"apiKey":{"type":"string","description":"Your model key: Anthropic key or Claude subscription token (claude), OpenAI key (codex), the provider's key (opencode), Google AI Studio key (gemini)."},"model":{"type":"string","description":"Optional model name (opencode: provider/model)."},"provider":{"type":"string","enum":["anthropic","openai","openrouter","google"],"description":"opencode only: whose key apiKey is (default anthropic)."},"cwd":{"type":"string","description":"Working directory (default: the repo)."}},"required":["computer","prompt","apiKey"],"additionalProperties":false}},{"name":"read_logs","title":"Read run output","description":"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.","http":"GET https://deskdigest.site/api/computers/logs","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"run":{"type":"string","description":"Run id from run_command, run_agent or create_computer (clone)."},"offset":{"type":"integer","description":"Byte offset (default 0).","minimum":0}},"required":["computer","run"],"additionalProperties":false}},{"name":"stop_run","title":"Stop a run","description":"Stops a run (SIGTERM to its whole process group), like a dev server or a stuck agent.","http":"POST https://deskdigest.site/api/computers/kill","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"run":{"type":"string","description":"Run id."}},"required":["computer","run"],"additionalProperties":false}},{"name":"read_file","title":"Read a file","description":"Reads a file from a running computer (up to 256 KB): text, or base64 for binary files.","http":"GET https://deskdigest.site/api/computers/file","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"path":{"type":"string","description":"Path, like ~/app/README.md."}},"required":["computer","path"],"additionalProperties":false}},{"name":"snapshot_computer","title":"Take a snapshot","description":"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).","http":"POST https://deskdigest.site/api/computers/snapshot","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"label":{"type":"string","description":"Optional label, like \"tests passing\"."}},"required":["computer"],"additionalProperties":false}},{"name":"restore_snapshot","title":"Restore a snapshot","description":"Rolls a stopped computer back to one of its snapshots; the next start boots from it.","http":"POST https://deskdigest.site/api/computers/restore","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"snapshot":{"type":"string","description":"Snapshot id from computer_status."}},"required":["computer","snapshot"],"additionalProperties":false}},{"name":"delete_computer","title":"Delete a computer","description":"Stops and deletes a computer with all its files and snapshots, for good. Needs confirm: \"delete\".","http":"POST https://deskdigest.site/api/computers/delete","inputSchema":{"type":"object","properties":{"computer":{"type":"string","description":"The computer id from create_computer, like c_ab12cd34ef56.","pattern":"^c_[a-z0-9]{12}$"},"token":{"type":"string","description":"The computer token from create_computer (ct_...). Not needed when you call with the owner's API key."},"confirm":{"type":"string","enum":["delete"],"description":"Must be \"delete\"."}},"required":["computer","confirm"],"additionalProperties":false}},{"name":"pricing","title":"Sizes, prices and limits","description":"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.","http":"GET https://deskdigest.site/api/pricing","inputSchema":{"type":"object","properties":{},"additionalProperties":false}}]}