sandbox_inspect
Return full configuration and metadata for one sandbox
How to use it
sandbox_inspect is exposed by the Microsandbox MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the sandbox_inspect tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Microsandbox MCP
claude mcp add --transport stdio microsandbox -- npx -y microsandbox-mcpOther tools in Microsandbox MCP (39)
Check whether the microsandbox runtime, msb, and libkrunfw are available
Install runtime dependencies using the microsandbox SDK installer
Create and boot a persistent sandbox with rootfs, resources, process, mounts, patches, network, secrets, and lifecycle options
Request graceful drain for selected sandboxes
Execute an argv command with env, cwd, user, TTY, timeout, rlimits, stdin, and output caps
Close and forget an exec session
Poll output events and exit status for an exec session
Send hup, int, term, kill, or a numeric signal to an exec session
Start a long-running command and return an in-memory exec session id
Write UTF-8 or base64 data to an exec session stdin
Copy a file within one sandbox or between two running sandboxes
Copy an allowlisted host path into a sandbox
Copy a sandbox path to an allowlisted host destination
Check whether a sandbox path exists
List sandbox directory entries
Create a sandbox directory
Read a sandbox file as UTF-8 text or base64 bytes
Remove a sandbox file or directory
Rename a sandbox file or directory
Get sandbox path metadata
Write UTF-8 text or base64 bytes to a sandbox file
List sandboxes with status, image, labels, and timestamps
Read captured logs with tail, time, source, grep, session id, and output cap filters
Poll captured logs using cursors and a bounded follow timeout
Get point-in-time metrics for one running sandbox
Get point-in-time metrics for all running sandboxes
Collect a bounded number of metrics samples from one sandbox
Remove selected stopped sandboxes, optionally force-stopping running ones first
Create an ephemeral sandbox, run a shell command, return output, and remove it
Execute a shell command string with the same execution controls
Start stopped sandboxes by name, labels, or status selector
Show status for one sandbox or a filtered sandbox set
Stop selected sandboxes gracefully or forcefully, with optional timeout
Wait until selected sandboxes reach a terminal state
Create a directory or disk-backed named volume with quota, capacity, and labels
Read a volume file as UTF-8 text or base64 bytes
Inspect one named volume
List named volumes with kind, quota, capacity, usage, disk format, labels, and timestamps
Remove one or more named volumes