Stdio MCP server for Fystash: room/sandbox/fabric/drive tools over public control-plane REST
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":"fystash-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.
# fystash-mcp Stdio [MCP](https://modelcontextprotocol.io) server for the Fystash control plane. Agents call tools (`room_create`, `sandbox_create`, `sandbox_exec`, …) which hit public HTTPS REST with your org API key. Production topology is **GCP nested KVM** (`topology=nested`). ## Install ```bash pip install fystash-mcp # or uvx fystash-mcp ``` ## Env ```bash export FYSTASH_API=https://34.138.50.46.sslip.io export FYSTASH_API_KEY='key-…' # from webapp Account / Billing success ``` ## Cursor / Claude Desktop (`mcp.json`) ```json { "mcpServers": { "fystash": { "command": "uvx", "args": ["fystash-mcp"], "env": { "FYSTASH_API": "https://34.138.50.46.sslip.io", "FYSTASH_API_KEY": "key-…" } } } } ``` Or with pip-installed console script: ```json { "mcpServers": { "fystash": { "command": "fystash-mcp", "env": { "FYSTASH_API": "https://34.138.50.46.sslip.io", "FYSTASH_API_KEY": "key-…" } } } } ``` ## Tools (SPEC §9) | Tool | REST twin | |------|-----------| | `health` | `GET /health` | | `room_create` / `room_get` / `room_destroy` | rooms | | `sandbox_create` | `POST …/sandboxes/from-template` | | `sandbox_exec` / `sandbox_destroy` | exec / delete sandbox | | `agent_send` / `agent_request` / `agent_fanout` / `agent_wait` | fabric | | `barrier_arrive` | barriers | | `fs_read` / `fs_write` / `fs_list` | room drive | | `audit_list` | audit | **guest_cid:** pick a unique int per sandbox, typically `9100–9999`, and do not reuse an in-use cid in the same room/host. ## Develop (this repo) ```bash export FYSTASH_API=https://34.138.50.46.sslip.io export FYSTASH_API_KEY=dev-key # or org key cd apps/mcp && uv run python -m fystash_mcp ``` See [docs/get-started.md](../../docs/get-started.md) and [skills/fystash/SKILL.md](../../skills/fystash/SKILL.md).
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.