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)

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.