get-started

Connect your agent

Drive Fystash from Cursor, Claude, or Codex via MCP. Prefer tools over curl.

Install

pip install fystash-mcp
# or
uvx fystash-mcp

Cursor / Claude Desktop

{
  "mcpServers": {
    "fystash": {
      "command": "uvx",
      "args": ["fystash-mcp"],
      "env": {
        "FYSTASH_API": "https://api.fystash.ai",
        "FYSTASH_API_KEY": "key-…"
      }
    }
  }
}

Or with the pip-installed console script:

{
  "mcpServers": {
    "fystash": {
      "command": "fystash-mcp",
      "env": {
        "FYSTASH_API": "https://api.fystash.ai",
        "FYSTASH_API_KEY": "key-…"
      }
    }
  }
}

Never invent or commit API keys. If env is missing, ask the user for FYSTASH_API + FYSTASH_API_KEY.

First prompts

After MCP is configured:

1. health then usage — stop if not entitled / zero credits

2. room_create with a unique id

3. sandbox_create agent_id=a1, guest_cid=9100, memory_mib=256

4. sandbox_exec echo hello

5. Report the room_id — it appears under Rooms in the webapp

The webapp is a prompt hub. Do not ask the user to click Create or Exec in the UI.

Agent discovery

• Short contract on the marketing site: https://fystash.ai/llms.txt
• Full docs index: https://docs.fystash.ai/llms.txt

Tool map

See MCP tools for the complete tool ↔ REST table.