Model Context Protocol server for forkd microVM sandboxes (BRANCH, diff snapshots, prewarm)
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"forkd-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# forkd MCP server An [MCP](https://modelcontextprotocol.io/) server that exposes forkd microVM sandboxes as tools to any MCP-aware client — Claude Desktop, Claude Code, Cursor, Cline, etc. ## What it lets the agent do Once registered, the agent can: | Tool | What | |---|---| | `list_snapshots` | See available parent templates | | `create_snapshot` | Build a new snapshot from kernel + rootfs (v0.2.0+) | | `spawn_sandboxes` | Fork N children from a template. Accepts `prewarm: bool` (v0.2.0+) | | `branch_sandbox` | **Branch a running sandbox into a new tag (v0.2.0+).** Accepts `diff: bool` for v0.3's 6-15× source-pause reduction on typical agent workloads (143× ceiling). | | `list_sandboxes` | List live sandboxes | | `get_sandbox` | Inspect one sandbox by id | | `exec_command` | Run a shell command in a sandbox | | `eval_code` | Evaluate Python against the warmed PID-1 | | `wait_for_text` | Poll a file in the guest for a marker string (v0.2.0+) | | `ping_sandbox` | Health-check a sandbox | | `kill_sandbox` | Terminate one sandbox | The killer one is **`branch_sandbox`**: pause a running agent sandbox, snapshot, fan out N children that inherit the source's exact state and diverge under copy-on-write. Modal does this as their proprietary moat; forkd is the open-source equivalent. See [`bench/pause-window/RESULTS-v0.3.md`](../../bench/pause-window/RESULTS-v0.3.md) for the measured numbers. Each tool maps 1:1 onto a forkd-controller REST endpoint ([`docs/API.md`](../../docs/API.md)). The server is stateless; the controller owns sandbox lifecycle. ## Install ```bash pip install forkd-mcp # or from source: pip install -e . ``` Requires the forkd-controller daemon running locally ([README](../../README.md#operating-in-daemon-mode)) and reachable on `http://127.0.0.1:8889` by default. ## Configure Environment variables: | Var | Default | Purpose | |---|---|---| | `FORKD_URL` | `http://127.0.0.1:8889` | Controller base URL | | `FORKD_TOKEN` | *unset* | Bearer toke…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.