KaBOOM + Windsurf

KaBOOM is an open-source MCP server that gives Windsurf’s AI access to browser console logs, network errors, exceptions, WebSocket events, and live DOM state. Zero dependencies.

Configuration

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

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

Usage

After restarting Windsurf, the AI can access all browser state:

• Console errors and warnings
• Failed network requests with response bodies
• WebSocket events and connection states
• Live DOM queries
• Accessibility audit results

Troubleshooting

1. Restart Windsurf after adding config
2. Check the KaBOOM extension popup — it should show “Connected”
3. Verify config path — must be ~/.codeium/windsurf/mcp_config.json