Create Sandbox
sandbox_createCreate and boot a persistent sandbox with custom resources, volumes, and environment. Configure CPU, memory, image, and startup files. The sandbox runs until stopped.
Instructions
Create and boot a persistent named sandbox with full configuration. The sandbox stays running until explicitly stopped.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"image": "<image>"
},
"name": "sandbox_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique sandbox name | |
| image | Yes | OCI image reference (e.g. "python:3.12", "ubuntu:24.04") | |
| cpus | No | Virtual CPUs (default: 1) | |
| memoryMib | No | Memory in MiB (default: 512) | |
| workdir | No | Default working directory inside the sandbox | |
| env | No | Environment variables | |
| volumes | No | Volume mounts | |
| patches | No | Rootfs modifications applied before boot | |
| entrypoint | No | Override image entrypoint | |
| hostname | No | Guest hostname | |
| maxDuration | No | Auto-stop after N seconds | |
| idleTimeout | No | Auto-stop after N seconds of inactivity |