Reference

MCP tools

The tools sandscale mcp offers your coding agent. Each one runs the matching sandscale command with your own sign-in, so every check and refusal is the command's. This page is generated from the server's tool list.

Connect

sandscale mcp is a stdio server. Add it to your coding tool with the command sandscale and the argument mcp; the Quickstart shows Claude Code, Codex and Cursor. It offers 13 tools. Signing in, the vault and deleting anything are not offered as tools, and Vault values never go to a model.

ToolWhat it doesChanges things
workspaces_listYour cloud workspaces.No
workspace_showOne workspace, by name or id.No
workspace_startStart a stopped workspace and wait until it runs.Yes
workspace_stopStop a workspace.Yes
sandboxes_listYour sandboxes.No
sandbox_showOne sandbox.No
sandbox_startStart a sandbox (from a template; the network is none unless asked).Yes
sandbox_execRun a command in a running sandbox; answers its exit code and output.Yes
sandbox_stopStop a sandbox.Yes
build_pools_listThe build host pools you can see.No
build_leases_listYour build host leases.No
build_lease_showOne build host lease.No
build_lab_hosts_listThe lab hosts you can see.No

workspaces_list

Your cloud workspaces. Read only.

No inputs.

workspace_show

One workspace, by name or id. Read only.

InputTypeRequiredAllowed values
workspacestringYesUp to 256 characters

workspace_start

Start a stopped workspace and wait until it runs. It changes something, so your coding tool may ask you first.

InputTypeRequiredAllowed values
workspacestringYesUp to 256 characters

workspace_stop

Stop a workspace. It changes something, so your coding tool may ask you first.

InputTypeRequiredAllowed values
workspacestringYesUp to 256 characters

sandboxes_list

Your sandboxes. Read only.

No inputs.

sandbox_show

One sandbox. Read only.

InputTypeRequiredAllowed values
sandboxstringYesUp to 256 characters

sandbox_start

Start a sandbox (from a template; the network is none unless asked). It changes something, so your coding tool may ask you first.

InputTypeRequiredAllowed values
templatestringNoUp to 256 characters
ttlstringNo^[0-9]{1,7}[smh]?$
networkstringNoUp to 32 characters

sandbox_exec

Run a command in a running sandbox; answers its exit code and output. It changes something, so your coding tool may ask you first.

InputTypeRequiredAllowed values
sandboxstringYesUp to 256 characters
commandarray of stringYesUp to 256 items
workdirstringNoUp to 1024 characters
timeout_secondsintegerNoAny

sandbox_stop

Stop a sandbox. It changes something, so your coding tool may ask you first.

InputTypeRequiredAllowed values
sandboxstringYesUp to 256 characters

build_pools_list

The build host pools you can see. Read only.

No inputs.

build_leases_list

Your build host leases. Read only.

InputTypeRequiredAllowed values
statestringNoactive, ended, all

build_lease_show

One build host lease. Read only.

InputTypeRequiredAllowed values
leasestringYesUp to 256 characters

build_lab_hosts_list

The lab hosts you can see. Read only.

No inputs.

This page is generated from the tool list of sandscale mcp (src/sandscale/mcp.ts). Do not edit it by hand.