Skip to content
VS Code

surfbird mcp for VS Code

io.github.terry2010/surfbird-mcp

Self-hosted Kitesurf headless browser: markdown, screenshots, PDF, evaluate, batch.

client:VS Code transport:stdio runtime:npm

Install surfbird mcp in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "surfbird-url",
      "description": "SURFBIRD_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "surfbird-token",
      "description": "SURFBIRD_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "surfbird-timeout-ms",
      "description": "SURFBIRD_TIMEOUT_MS",
      "password": true
    }
  ],
  "servers": {
    "surfbird-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "surfbird-mcp"
      ],
      "env": {
        "SURFBIRD_URL": "${input:surfbird-url}",
        "SURFBIRD_TOKEN": "${input:surfbird-token}",
        "SURFBIRD_TIMEOUT_MS": "${input:surfbird-timeout-ms}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

surfbird mcp in other clients