Sandbox tools

Sandbox tools. Tool names are exact: sandbox tools are prefixed sandbox_.

Sandboxes

ToolDescription
sandbox_createCreate a lightweight code sandbox using a canonical named size. Defaults to small (2 vCPU, 4 GB RAM, 10 GB disk).
sandbox_deployDeploy sandbox contents to production through MIOSA.
sandbox_deploy_dockerDeploy sandbox contents through the workspace App Engine runtime. Uses MIOSA native APIs, not an external deploy MCP.
sandbox_destroyDestroy a sandbox permanently.
sandbox_execRun a bash command inside a sandbox and return the output.
sandbox_exposeExpose a port on a sandbox and return a publicly accessible preview URL.
sandbox_getGet details of a specific sandbox.
sandbox_listList all sandboxes in the tenant.
sandbox_list_filesList files in a directory inside a sandbox.
sandbox_logsGet logs from a sandbox.
sandbox_pausePause a running sandbox (suspends it to save compute).
sandbox_pythonRun Python code inside a sandbox and return stdout, stderr, and exit code.
sandbox_read_fileRead a file from inside a sandbox and return its content as text.
sandbox_resumeResume a paused sandbox.
sandbox_uploadUpload binary content into a sandbox. content must be base64-encoded and is decoded before it is written. For plain text prefer sandbox_write_file.
sandbox_write_fileWrite text or binary content to a file path inside a sandbox.

Sandbox snapshots and templates

ToolDescription
sandbox_snapshot_createCreate a snapshot of the current sandbox state.
sandbox_snapshot_listList all snapshots for a sandbox.
sandbox_snapshot_restoreRestore a sandbox from a specific snapshot.
sandbox_template_buildsList builds for a sandbox template.
sandbox_template_createCreate a custom sandbox template from a build spec.
sandbox_template_getGet details of a specific sandbox template.
sandbox_template_listList tenant-owned sandbox templates for custom sandbox environments. For canonical product/template/size readiness, use product_template_list.

Durable runs

ToolDescription
run_createCreate a durable run for an agent or command on a Sandbox or Computer.
run_listList durable runs in the current organization.
run_getGet a durable run.
run_cancelCancel a durable run.
run_outputsGet structured outputs for a durable run.
run_messagesGet messages emitted by a durable run.
run_filesList files produced by a durable run.
Was this page helpful?