fystash-mcp 0.1.0

Stdio MCP server for Fystash: room/sandbox/fabric/drive tools over public control-plane REST

fystash-mcp

Stdio MCP 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

pip install fystash-mcp
# or
uvx fystash-mcp

Env

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)

{
  "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:

{
  "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)

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 and skills/fystash/SKILL.md.