Wrave

High-performance Model Context Protocol (MCP) gateway for Brave Browser.
Direct, low-latency browser automation for Claude Code, Antigravity, Codex, Cursor, and MCP clients.

Overview

Wrave provides full programmatic control of your active Brave browser session through the Model Context Protocol (MCP). It gives coding assistants and developer workflows direct access to interact with, inspect, and navigate live web applications:

• 1-Turn Compound Actions: High-speed primitives like click_and_read and type_and_submit that combine interaction and page inspection into a single round-trip.

• Semantic Element Indexing: Surfaces interactive elements with numbered references (@1, @2, @3, etc.), bounding boxes, and accessibility roles—eliminating brittle CSS selectors on dynamic apps.

• Full-Spectrum Inspection: Clean DOM trees, accessibility hierarchies, full-page or viewport screenshots, intercepted console logs, network cookies, and tab state.

• Dual Transport Modes: Works out of the box on demand via stdio (zero background services to manage) or as a local HTTP/SSE service.

• Zero Browser Modifications: Runs directly alongside your everyday browser session without requiring special startup flags or separate browser drivers.

Related MCP server: hronaut

Installation in Brave Browser

1. Download the latest wrave-extension-v*.zip from GitHub Releases and extract it.

2. Open Brave and navigate to:

   brave://extensions

3. Enable the Developer mode toggle in the top-right corner.

4. Click Load unpacked and select the extracted folder.

5. (Optional) Pin the Wrave icon to your toolbar for quick status monitoring.

Connect Your Client

Wrave supports automatic stdio launching (recommended) and connecting to a persistent local server.

1. Google Antigravity

Add Wrave to ~/.gemini/config/mcp_config.json:

Option A: On-Demand Stdio (Recommended)

{
  "mcpServers": {
    "wrave": {
      "command": "npx",
      "args": ["-y", "wrave-mcp", "--stdio"]
    }
  }
}

Option B: Persistent Local Server

If running npx wrave-mcp --server:

{
  "mcpServers": {
    "wrave": {
      "serverUrl": "http://127.0.0.1:8282/mcp"
    }
  }
}

2. Claude Code (CLI)

Add to Claude Code with a single command:

# On-demand stdio (recommended)
claude mcp add wrave -- npx -y wrave-mcp --stdio

# Or connect to a running local server:
claude mcp add wrave -- http://127.0.0.1:8282/mcp/sse

3. Claude Desktop

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wrave": {
      "command": "npx",
      "args": ["-y", "wrave-mcp", "--stdio"]
    }
  }
}

4. OpenAI Codex & OpenCode

Add to your opencode.json configuration:

{
  "mcp": {
    "servers": {
      "wrave": {
        "command": "npx",
        "args": ["-y", "wrave-mcp", "--stdio"]
      }
    }
  }
}

Or connect via HTTP endpoint:

{
  "mcp": {
    "servers": {
      "wrave": {
        "url": "http://127.0.0.1:8282/mcp"
      }
    }
  }
}

5. Cursor & Windsurf

Add to ~/.cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "wrave": {
      "command": "npx",
      "args": ["-y", "wrave-mcp", "--stdio"]
    }
  }
}

Available MCP Tools (21 Primitives)

Compound Actions (1-Turn)

Core Navigation & Inspection

Direct Interaction Primitives

Development & Building from Source

# 1. Clone repository
git clone https://github.com/AMARA-Khaled/wrave.git
cd wrave

# 2. Install dependencies
npm install

# 3. Build codebase
npm run build

# 4. Run automated test suite
npm test

# 5. Package extension bundle
npm run pack:extension

License

MIT © AMARA Khaled