How to Connect KaBOOM to Windsurf

If you use Windsurf and want real browser evidence during development, this guide is for you.

Quick Terms

• MCP (Model Context Protocol): A tool integration standard for AI assistants. https://modelcontextprotocol.io/specification/
• Runtime evidence: What actually happened in the browser (errors, requests, page state).

Step 1: Check KaBOOM availability

npx -y kaboom-agentic-browser --help

Step 2: Add KaBOOM to your Windsurf MCP servers

{
  "mcpServers": {
    "kaboom": {
      "command": "npx",
      "args": ["-y", "kaboom-agentic-browser"]
    }
  }
}

Step 3: Restart Windsurf

Windsurf needs a restart to load new MCP entries.

Step 4: Run your first checks

observe({what: "errors"})
observe({what: "logs", min_level: "error"})

Step 5: Create a concrete artifact

generate({what: "reproduction"})

This gives your team a reproducible script instead of vague notes.

Image and Diagram Callouts

[Image Idea] Windsurf MCP config with KaBOOM server entry.

[Diagram Idea] Windsurf request -> KaBOOM tools -> bug artifact output.