Claude MCP Configuration

The server auto-configures Claude Code on startup. To manually configure:

Claude Code (CLI)

claude mcp add --transport http --scope user hero_browser http://localhost:8884/mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hero_browser": {
      "transport": "http",
      "url": "http://localhost:8884/mcp"
    }
  }
}

Verify

# List configured MCP servers
claude mcp list

# Test the connection
curl -s http://localhost:8884/api/sessions | jq

API Endpoints

• POST /rpc — JSON-RPC proxy (all UI operations)
• POST /mcp — MCP protocol endpoint (AI tools)

RPC Methods

• browser.list_sessions — List active browser sessions
• browser.get_activity — Get all activity log entries
• browser.get_session_activity — Get activity for a session

Available Tools

40+ browser automation tools:

• Browser management (create, destroy, list)
• Page operations (navigate, screenshot, content)
• Element interaction (click, type, hover, wait)
• JavaScript execution & console monitoring