Hardware-isolated Linux sandbox for AI agents — Firecracker MicroVM + MCP
BunkerVM defines 6 tools with clear verb-noun naming (sandbox_exec, sandbox_read_file, etc.) and comprehensive descriptions (150-250 chars each). All tools have input schemas with typed parameters and descriptions. Tool annotations are present (readOnlyHint, destructiveHint, idempotentHint). However, output schemas are not documented, responses are described in prose but lack formal JSON Schema definitions. Error handling is basic (generic error strings). Parameters lack constraints (e.g., timeout accepts 1-300 but no enum/min/max in schema). No pagination support for list operations. Security annotations present but no explicit permission gates or scope declarations in tool definitions.
Execute a shell command inside the hardware-isolated Linux sandbox. The sandbox is a full Alpine Linux environment running in a Firecracker MicroVM with KVM hardware isolation. Commands run as root inside the VM. The host system is completely protected. Common uses: - Run any Linux command: ls, cat, grep, awk, sed, curl, python3, etc. - Install packages: apk add <package> - Compile and run code - Inspect system state: ps, top, free, df, ip addr - Process data, transform files, run scripts
List the contents of a directory in the sandbox. Returns file names, types (file/directory/symlink), sizes, and permissions.
Read the contents of a file from the sandbox filesystem. Supports text files (returned as UTF-8) and binary files (returned as base64). Maximum file size: 2MB.
Destroy and recreate the sandbox VM. Wipes all state and boots a fresh Alpine Linux environment.
Get sandbox VM health and resource usage. Returns CPU, memory, disk usage, uptime, and health status.
Output schemas not documented. Tool descriptions state what is returned in prose ('Command output with exit code, stdout, stderr...') but no formal JSON Schema definition. LLMs cannot reliably parse unstructured responses or plan downstream tool calls.
Parameter constraints missing from schema. timeout parameter accepts 1-300 but schema shows only type:integer with no min/max. LLMs may pass invalid values (e.g., timeout=500). Constraints should be in JSON Schema (minimum, maximum, enum).
No pagination support for list_dir. If a directory contains thousands of files, the response will be truncated or blow the context window. Should accept limit and offset/cursor parameters and return total_count.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 69 | 2026-07-28+ | v2 |
Write content to a file in the sandbox filesystem. Creates parent directories automatically. Can overwrite or append.
Error handling lacks recovery guidance. Errors return generic strings ('Sandbox unreachable', 'ERROR') without actionable next steps. Should categorize errors (retryable vs fatal) and suggest recovery actions.
No dry-run or confirmation for irreversible operations. sandbox_reset destroys the VM with no confirmation step. Agents make mistakes, should support a confirm_before_execute pattern or require explicit user approval.