@sandflare/mcp-server

MCP server for Sandflare — run sandboxes and managed PostgreSQL databases from Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Installation

No install required. Run directly with npx:

SANDFLARE_API_KEY=pa_live_... npx -y @sandflare/mcp-server

Get your API key at app.sandflare.io/settings/api-keys.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sandflare": {
      "command": "npx",
      "args": ["-y", "@sandflare/mcp-server"],
      "env": {
        "SANDFLARE_API_KEY": "pa_live_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. You'll see the 🔨 hammer icon when the server is connected.

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "sandflare": {
      "command": "npx",
      "args": ["-y", "@sandflare/mcp-server"],
      "env": {
        "SANDFLARE_API_KEY": "pa_live_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sandflare": {
      "command": "npx",
      "args": ["-y", "@sandflare/mcp-server"],
      "env": {
        "SANDFLARE_API_KEY": "pa_live_YOUR_KEY_HERE"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | create_sandbox | Create a new microVM sandbox | | delete_sandbox | Delete a sandbox | | exec | Run a shell command in a sandbox | | run_python | Execute Python code (fresh interpreter) | | run_node | Execute JavaScript/Node.js code | | run_code | Execute Python in a persistent stateful kernel | | write_file | Write a file to the sandbox filesystem | | read_file | Read a file from the sandbox filesystem | | list_files | List files and directories | | list_sandboxes | List all running sandboxes | | create_database | Create a managed PostgreSQL database | | list_databases | List all databases | | delete_database | Delete a database | | wire_database | Connect a sandbox to a database (injects DATABASE_URL) |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SANDFLARE_API_KEY | ✅ | Your API key (pa_live_...) | | SANDFLARE_API_URL | Optional | Override API base URL (default: https://api.sandflare.io) |

Example prompts

"Create a sandbox and run a Python script that fetches the Bitcoin price"

"Create a sandbox, create a PostgreSQL database, wire them together, then create a users table"

"Use the stateful kernel to import pandas, load a CSV, and show me summary statistics"