brave-real-browser-mcp-server 2.12.7 → 2.12.8

package/README.md

@@ -14,7 +14,7 @@
 
 [📖 **All 5 Protocols Complete Guide**](./ALL-PROTOCOLS.md) 👈 **NEW! Step-by-step setup for all protocols**
 
-[Installation](#-installation) | [Quick Start](#-quick-start) | [Tools](#-available-tools-111) | [HTTP/WebSocket](#-httpwebsocket-setup) | [Configuration](#-ide-configurations) | [Troubleshooting](#-troubleshooting)
+[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-111) | [HTTP/WebSocket/SSE](#-httpwebsocketsse-protocol-setup) | [IDE Configurations](#-ide-configurations)
 
 </div>
 
@@ -45,7 +45,7 @@
 | **Cursor AI** | 2 min | MCP | Add config → Restart |
 | **Windsurf** | 2 min | MCP | Add config → Restart |
 | **Zed Editor** | 3 min | LSP | Add to `context_servers` → Restart |
-| **Qoder AI** | 4 min | HTTP | Start HTTP server → Add config → Restart |
+|| **Qoder AI** | 3 min | MCP (STDIO/SSE) | Add config → Restart |
 | **Custom Apps** | 1 min | HTTP/WebSocket/SSE | Start server → Use API |
 
 **Quick Commands:**
@@ -104,15 +104,26 @@ npx brave-real-browser-mcp-server@latest
 - **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
 - **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
 
-### For Other IDEs (Qoder AI, Custom Tools)
+### For Qoder AI
 
-Use HTTP/WebSocket mode - [See HTTP/WebSocket Setup](#-httpwebsocket-setup)
+**Qoder AI supports 2 MCP transport types:** STDIO (local) and SSE (remote)
+
+**Complete step-by-step guide:** [See Qoder AI Integration Guide](#-qoder-ai---complete-integration-guide)
+
+**Quick setup (STDIO):**
+1. Add to config: `{"command": "npx", "args": ["-y", "brave-real-browser-mcp-server@latest"]}`
+2. Restart Qoder AI
+3. Use 111 browser automation tools!
+
+### For Other Custom Tools
+
+Use HTTP/WebSocket/SSE mode - [See Protocol Setup](#-httpwebsocketsse-protocol-setup)
 
 ---
 
-## 🌐 HTTP/WebSocket Setup
+## 🌐 HTTP/WebSocket/SSE Protocol Setup
 
-### HTTP Protocol - 5 Steps
+### 1️⃣ HTTP Protocol - Complete Configuration
 
 HTTP mode works with **ANY IDE or programming language**. No special configuration needed!
 
@@ -127,6 +138,10 @@ npx brave-real-browser-mcp-server@latest --mode http --host 0.0.0.0 --port 8080
 
 # HTTP only (without WebSocket)
 npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
+
+# With custom Brave browser path
+set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
+npx brave-real-browser-mcp-server@latest --mode http --port 3000
 ```
 
 **Server will start and show:**
@@ -134,6 +149,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
 ```
 🟢 [HTTP] Starting HTTP/WebSocket server...
 ✅ [HTTP] Server ready at http://localhost:3000
+✅ [WebSocket] Server running on ws://localhost:3000
 💡 [HTTP] Universal mode - works with ALL AI IDEs
 ```
 
@@ -145,29 +161,78 @@ curl http://localhost:3000/health
 
 # List all available tools
 curl http://localhost:3000/tools
+
+# Get specific tool info
+curl http://localhost:3000/tools/browser_init
 ```
 
-#### Step 5: Configure in Your IDE
+#### Step 3: Available HTTP Endpoints
 
-**For Qoder AI:**
+| Method | Endpoint | Description | Example |
+|--------|----------|-------------|----------|
+| **GET** | `/health` | Health check | `curl http://localhost:3000/health` |
+| **GET** | `/tools` | List all 111 tools | `curl http://localhost:3000/tools` |
+| **GET** | `/tools/:toolName` | Get tool info | `curl http://localhost:3000/tools/browser_init` |
+| **POST** | `/tools/:toolName` | Execute any tool | See documentation |
 
+#### Step 4: MCP Configuration for HTTP
+
+If your IDE supports HTTP-based MCP servers, use this configuration:
+
+**Config format:**
 ```json
 {
-  "extensions": {
-    "brave-real-browser": {
-      "type": "http",
-      "enabled": true,
-      "endpoint": "http://localhost:3000"
+  "mcpServers": {
+    "brave-real-browser-http": {
+      "url": "http://localhost:3000",
+      "transport": "http",
+      "name": "Brave Browser (HTTP)",
+      "enabled": true
+    }
+  }
+}
+```
+
+**With authentication:**
+```json
+{
+  "mcpServers": {
+    "brave-real-browser-http": {
+      "url": "http://localhost:3000",
+      "transport": "http",
+      "headers": {
+        "Authorization": "Bearer your-token"
+      },
+      "enabled": true
     }
   }
 }
 ```
 
-**For any custom tool:** Just make HTTP POST requests to `http://localhost:3000/tools/{tool_name}`
+#### Step 5: Error Handling
+
+**Success Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "result": "Browser initialized successfully"
+  }
+}
+```
+
+**Error Response:**
+```json
+{
+  "success": false,
+  "error": "Browser initialization failed",
+  "details": "Brave browser not found at specified path"
+}
+```
 
 ---
 
-### WebSocket Protocol - Complete Setup Guide
+### 2️⃣ WebSocket Protocol - Complete Configuration
 
 WebSocket provides **real-time, bidirectional communication** for modern applications.
 
@@ -189,272 +254,223 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
 💡 [HTTP] Universal mode - works with ALL AI IDEs
 ```
 
-#### Step 6: WebSocket Advanced Features
-
-**Connection Options:**
+#### Step 2: WebSocket Message Format
 
-```javascript
-const ws = new WebSocket('ws://localhost:3000', {
-  headers: {
-    'Authorization': 'Bearer your-token',
-    'X-Custom-Header': 'value'
+**Request Format:**
+```json
+{
+  "tool": "tool_name",
+  "params": {
+    "param1": "value1",
+    "param2": "value2"
   }
-});
+}
 ```
 
-**Reconnection Logic:**
-
-```javascript
-function connectWebSocket() {
-  const ws = new WebSocket('ws://localhost:3000');
-  
-  ws.on('close', () => {
-    console.log('Connection closed, reconnecting in 5s...');
-    setTimeout(connectWebSocket, 5000);
-  });
-  
-  ws.on('error', (error) => {
-    console.error('WebSocket error:', error);
-  });
-  
-  return ws;
+**Response Format:**
+```json
+{
+  "success": true,
+  "tool": "browser_init",
+  "data": {
+    "result": "Browser initialized successfully"
+  },
+  "timestamp": "2025-01-25T04:20:00.000Z"
 }
-
-const ws = connectWebSocket();
 ```
 
-**Heartbeat/Ping-Pong:**
+#### Step 3: MCP Configuration for WebSocket
 
-```javascript
-const ws = new WebSocket('ws://localhost:3000');
+If your IDE supports WebSocket-based MCP servers:
 
-setInterval(() => {
-  if (ws.readyState === WebSocket.OPEN) {
-    ws.ping();
+**Config format:**
+```json
+{
+  "mcpServers": {
+    "brave-real-browser-ws": {
+      "url": "ws://localhost:3000",
+      "transport": "websocket",
+      "name": "Brave Browser (WebSocket)",
+      "enabled": true
+    }
   }
-}, 30000); // Ping every 30 seconds
-
-ws.on('pong', () => {
-  console.log('Pong received - connection alive');
-});
+}
 ```
 
-#### Troubleshooting WebSocket
-
-**Issue: Connection Refused**
-
-```bash
-# Check if HTTP server is running
-curl http://localhost:3000/health
-
-# If not running, start it:
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
+**With custom options:**
+```json
+{
+  "mcpServers": {
+    "brave-real-browser-ws": {
+      "url": "ws://localhost:3000",
+      "transport": "websocket",
+      "reconnect": true,
+      "reconnectDelay": 3000,
+      "headers": {
+        "Authorization": "Bearer your-token"
+      },
+      "enabled": true
+    }
+  }
+}
 ```
 
-**Issue: WebSocket Disabled**
+#### Step 4: WebSocket Features
 
-```bash
-# Start server with WebSocket explicitly enabled
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
+**WebSocket URL:** `ws://localhost:3000`
 
-# Note: WebSocket is enabled by default
-# To disable: use --no-websocket flag
-```
+**Features:**
+- ✅ Real-time bidirectional communication
+- ✅ Auto-reconnection support
+- ✅ Ping/Pong keep-alive
+- ✅ Custom headers support
+- ✅ All 111 tools accessible
 
-**Issue: Connection Timeout**
+---
 
-```javascript
-// Increase connection timeout
-const ws = new WebSocket('ws://localhost:3000', {
-  handshakeTimeout: 10000 // 10 seconds
-});
-```
+### 3️⃣ SSE Protocol - Complete Configuration
 
-**Issue: Firewall Blocking**
+Server-Sent Events (SSE) provides **real-time, one-way streaming** from server to client.
+
+#### Step 1: Start SSE Server
 
 ```bash
-# Windows - Allow Node.js through firewall
-netsh advfirewall firewall add rule name="Node.js WebSocket" dir=in action=allow program="C:\Program Files\nodejs\node.exe" enable=yes
+# Default (port 3001)
+npx brave-real-browser-mcp-server@latest --mode sse
 
-# Linux - Allow port 3000
-sudo ufw allow 3000
-```
+# Custom port
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
 
-## 🎨 IDE Configurations
+# Custom host
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001 --host 0.0.0.0
 
-### Claude Desktop
+# With custom Brave path
+set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
+```
 
-**Protocol:** MCP (STDIO) | **Setup Time:** 2 minutes | **Auto-Start:** ✅ Yes
+**Server will start and show:**
 
-#### 📋 Step-by-Step Setup Guide:
+```
+🟢 [SSE] Starting SSE server...
+✅ [SSE] Server ready at http://localhost:3001
+💡 [SSE] Real-time monitoring enabled
+```
 
-**Step 1: Locate Configuration File**
+#### Step 2: Test SSE Server
 
 ```bash
-# Windows (PowerShell)
-cd $env:APPDATA\Claude
-notepad claude_desktop_config.json
-
-# Windows (CMD)
-cd %APPDATA%\Claude
-notepad claude_desktop_config.json
-
-# Mac
-cd ~/Library/Application\ Support/Claude
-open -e claude_desktop_config.json
+# Health check
+curl http://localhost:3001/health
 
-# Linux
-cd ~/.config/Claude
-gedit claude_desktop_config.json
+# List available event types
+curl http://localhost:3001/events/types
 ```
 
-**If file doesn't exist, create it:**
+#### Step 3: Available SSE Event Types
 
-```bash
-# Windows (PowerShell)
-New-Item -Path "$env:APPDATA\Claude\claude_desktop_config.json" -ItemType File -Force
-
-# Mac/Linux
-mkdir -p ~/.config/Claude
-touch ~/.config/Claude/claude_desktop_config.json
-```
+| Event Type | Description | Example Data |
+|------------|-------------|-------------|
+| `browser_init_success` | Browser initialized | `{"status": "ready", "pid": 12345}` |
+| `browser_init_error` | Browser failed to start | `{"error": "Brave not found"}` |
+| `navigation_start` | Navigation started | `{"url": "https://example.com"}` |
+| `navigation_complete` | Navigation finished | `{"url": "https://example.com", "time": 1250}` |
+| `tool_start` | Tool execution started | `{"tool": "scrape_table"}` |
+| `tool_success` | Tool completed successfully | `{"tool": "scrape_table", "result": [...]}` |
+| `tool_error` | Tool execution failed | `{"tool": "scrape_table", "error": "Selector not found"}` |
+| `content_extracted` | Content extracted | `{"type": "html", "size": 50000}` |
+| `screenshot_captured` | Screenshot taken | `{"path": "/path/to/screenshot.png"}` |
+| `error_occurred` | General error | `{"error": "Connection timeout"}` |
 
-**Step 2: Add Configuration**
+#### Step 4: MCP Configuration for SSE
 
-Copy and paste this configuration:
+If your IDE supports SSE-based MCP servers:
 
+**Config format:**
 ```json
 {
   "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
+    "brave-real-browser-sse": {
+      "url": "http://localhost:3001/sse",
+      "transport": "sse",
+      "name": "Brave Browser (SSE)",
+      "enabled": true
     }
   }
 }
 ```
 
-**Advanced Configuration (Optional):**
-
+**With event filters:**
 ```json
 {
   "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
-        "HEADLESS": "false"
-      }
+    "brave-real-browser-sse": {
+      "url": "http://localhost:3001/sse?filter=tool_success,navigation_complete",
+      "transport": "sse",
+      "reconnect": true,
+      "enabled": true
     }
   }
 }
 ```
 
-**Step 3: Save and Close File**
-
-Press `Ctrl+S` (Windows/Linux) or `Cmd+S` (Mac) to save.
-
-**Step 4: Restart Claude Desktop**
+#### Step 5: SSE Advanced Features
 
+**Custom Event Filters:**
 ```bash
-# Windows
-taskkill /F /IM claude.exe
-# Then reopen Claude Desktop
-
-# Mac
-pkill -f Claude
-# Then reopen Claude Desktop
+# Connect with filter query parameter
+curl http://localhost:3001/events?filter=tool_success,navigation_complete
 ```
 
-**Step 5: Verify Installation**
-
-1. Open Claude Desktop
-2. Look for 🔧 icon or "Tools" section
-3. You should see "brave-real-browser" with 111 tools
-4. Try this command in Claude:
-   ```
-   Use browser_init tool to start the browser
-   ```
-
-**Troubleshooting:**
-
-```bash
-# Check Claude logs
-# Windows
-type "%APPDATA%\Claude\logs\mcp*.log"
-
-# Mac
-cat ~/Library/Logs/Claude/mcp*.log
+---
 
-# If server fails, test manually:
-npx -y brave-real-browser-mcp-server@latest
-```
+## 🤖 Qoder AI - Complete Integration Guide
 
-**Configuration Locations:**
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Linux: `~/.config/Claude/claude_desktop_config.json`
+**Qoder AI** supports MCP servers through **2 official transport types:**
+- ✅ **STDIO** (Standard Input/Output) - For local MCP servers
+- ✅ **SSE** (Server-Sent Events) - For remote MCP servers
 
-### Cursor AI
+[Official Documentation](https://docs.qoder.com/user-guide/chat/model-context-protocol)
 
-**Protocol:** MCP (STDIO) | **Setup Time:** 2 minutes | **Auto-Start:** ✅ Yes
+---
 
-#### 📋 Step-by-Step Setup Guide:
+### 🟢 Method 1: STDIO Transport (Recommended for Local)
 
-**Step 1: Install Cline Extension (if not installed)**
+**STDIO** uses stdin/stdout streams for communication. Perfect for local MCP servers.
 
-1. Open Cursor AI
-2. Press `Ctrl+Shift+X` (Extensions)
-3. Search for "Cline" or "Claude Dev"
-4. Click Install
-5. Restart Cursor
+#### Step 1: Find Qoder AI MCP Config File
 
-**Step 2: Locate Configuration File**
+**Config file locations:**
 
 ```bash
-# Windows (PowerShell)
-$configPath = "$env:APPDATA\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings"
-cd $configPath
-notepad cline_mcp_settings.json
-
-# Windows (CMD)
-cd %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings
-notepad cline_mcp_settings.json
+# Windows
+%APPDATA%\Qoder\mcp_settings.json
 
 # Mac
-cd ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings
-open -e cline_mcp_settings.json
-```
-
-**If file doesn't exist, create it:**
-
-```bash
-# Windows (PowerShell)
-$settingsPath = "$env:APPDATA\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings"
-New-Item -Path $settingsPath -ItemType Directory -Force
-New-Item -Path "$settingsPath\cline_mcp_settings.json" -ItemType File -Force
+~/Library/Application Support/Qoder/mcp_settings.json
 
-# Mac
-mkdir -p ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings
-touch ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+# Linux
+~/.config/Qoder/mcp_settings.json
 ```
 
-**Step 3: Add Configuration**
+#### Step 2: Add STDIO Configuration
 
-**Basic Configuration:**
+**Windows Configuration:**
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
       "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+      }
     }
   }
 }
 ```
 
-**Advanced Configuration (with Brave path):**
+**Mac Configuration:**
 ```json
 {
   "mcpServers": {
@@ -462,15 +478,14 @@ touch ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claud
       "command": "npx",
       "args": ["-y", "brave-real-browser-mcp-server@latest"],
       "env": {
-        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
-        "HEADLESS": "false"
+        "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
       }
     }
   }
 }
 ```
 
-**For Mac:**
+**Linux Configuration:**
 ```json
 {
   "mcpServers": {
@@ -478,251 +493,238 @@ touch ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claud
       "command": "npx",
       "args": ["-y", "brave-real-browser-mcp-server@latest"],
       "env": {
-        "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+        "BRAVE_PATH": "/usr/bin/brave-browser"
       }
     }
   }
 }
 ```
 
-**Step 4: Save and Restart Cursor**
-
-```bash
-# Windows
-taskkill /F /IM Cursor.exe
-# Then reopen Cursor
-
-# Mac
-pkill -f Cursor
-# Then reopen Cursor
-```
+#### Step 3: Restart Qoder AI
 
-**Step 5: Verify Installation**
+Close and reopen Qoder AI completely.
 
-1. Open Cursor AI
-2. Open Cline panel (usually in sidebar)
-3. Look for MCP tools section
-4. You should see "brave-real-browser" listed
-5. Test with:
-   ```
-   @brave-real-browser browser_init
-   ```
+#### Step 4: Verify Integration
 
-**Step 6: Using Tools in Cursor**
+In Qoder AI, test:
 
 ```
-# In Cline chat:
-Use the browser_init tool from brave-real-browser to start automation
+"List all available MCP tools"
+→ Expected: 111 tools from Brave Real Browser
 
-# Or directly:
-@brave-real-browser navigate {"url": "https://example.com"}
+"Use browser_init to start the browser"
+→ Expected: Browser opens
+
+"Navigate to https://example.com and get content"
+→ Expected: Page content extracted
 ```
 
-**Troubleshooting:**
+---
 
-```bash
-# Check if Cline extension is active
-# Cursor → Extensions → Search "Cline" → Should show "Active"
+### 🔵 Method 2: SSE Transport (For Remote MCP Servers)
 
-# View Cline logs
-# Cursor → View → Output → Select "Cline" from dropdown
+**SSE** uses HTTP POST for requests and event streams for responses. Perfect for remote hosted servers.
 
-# Test server manually
-npx -y brave-real-browser-mcp-server@latest
+#### Step 1: Start SSE Server
 
-# Clear Cursor cache
+```bash
 # Windows
-Remove-Item -Recurse -Force "$env:APPDATA\Cursor\Cache"
+set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
 
 # Mac
-rm -rf ~/Library/Application\ Support/Cursor/Cache
-```
-
-**Configuration Locations:**
-- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
-- Mac: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+export BRAVE_PATH="/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
 
-### Windsurf
+# Linux
+export BRAVE_PATH="/usr/bin/brave-browser"
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
+```
 
-**File:** `mcp.json`
+**Server will start:**
+```
+🟢 [SSE] Starting SSE server...
+✅ [SSE] Server ready at http://localhost:3001
+💡 [SSE] Real-time monitoring enabled
+```
 
-**Location:**
+#### Step 2: Configure Qoder AI for SSE
 
-- Windows: `%APPDATA%\Windsurf\mcp.json`
-- Mac: `~/.windsurf/mcp.json`
+**In Qoder AI Settings → MCP Servers:**
 
 ```json
 {
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
-    }
+  "brave-real-browser": {
+    "url": "http://localhost:3001/sse",
+    "transport": "sse",
+    "name": "Brave Real Browser (SSE)",
+    "enabled": true
   }
 }
 ```
 
-### Cline (VSCode Extension)
-
-**File:** `cline_mcp_settings.json`
+#### Step 3: Restart Qoder AI
 
-**Location:**
+Close and reopen Qoder AI.
 
-- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
-- Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+---
 
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
-    }
-  }
-}
-```
+### 🛠️ Using Brave Browser in Qoder AI
 
-### Zed Editor
+Once configured, you can use **all 111 tools** in Qoder AI:
 
-**Protocol:** Context Servers (MCP)
+**Example 1: Web Scraping**
+```
+"Initialize browser, navigate to https://news.ycombinator.com and scrape all article titles"
+```
 
-**File:** `settings.json`
+**Example 2: Form Automation**
+```
+"Open https://example.com/login, fill the form with username 'test' and password 'pass123', then click submit"
+```
 
-**Location:**
+**Example 3: Data Extraction**
+```
+"Go to https://example.com/products and extract all product names, prices, and images"
+```
 
-- Windows: `%APPDATA%\Zed\settings.json`
-- Mac: `~/.config/zed/settings.json`
-- Linux: `~/.config/zed/settings.json`
+**Example 4: Video Extraction**
+```
+"Navigate to [video URL] and extract all video download links"
+```
 
-#### Step-by-Step Setup Guide:
+**Example 5: Screenshot**
+```
+"Take a full-page screenshot of https://example.com and save it"
+```
 
-**Step 1:** Open Zed Editor and press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (Mac)
+---
 
-**Step 2:** Type "Open Settings" and select "Zed: Open Settings"
+### ⚡ Quick Troubleshooting for Qoder AI
 
-**Step 3:** Add the following configuration:
+**Problem 1: "MCP Server timeout" or "Connection failed"**
 
-```json
-{
-  "context_servers": {
-    "brave-real-browser": {
-      "source": "custom",
-      "command": "npx.cmd",
-      "args": ["-y", "brave-real-browser-mcp-server"]
-    }
-  }
-}
+**Solution:**
+```bash
+# Install globally for faster startup
+npm install -g brave-real-browser-mcp-server@latest
 ```
 
-**For Mac/Linux, use:**
+Then update config to:
 ```json
 {
-  "context_servers": {
+  "mcpServers": {
     "brave-real-browser": {
-      "source": "custom",
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server"]
+      "command": "brave-real-browser-mcp-server",
+      "args": []
     }
   }
 }
 ```
 
-**Step 4:** Save the file and restart Zed Editor
-
-**Step 5:** Verify installation by checking Zed's output panel
-
-**Important Notes:**
-- ⚠️ **Zed uses `context_servers` NOT `mcpServers` or `lsp`**
-- ✅ Make sure you're using Zed Preview version (v0.120.0+) for MCP support
-- ✅ On Windows, use `npx.cmd` instead of `npx`
-- ✅ Server will auto-start when Zed launches
+**Problem 2: "Tools not showing in Qoder AI"**
 
-### Qoder AI Editor
+**Solution:**
+1. Check config file path is correct
+2. Verify JSON format is valid
+3. Restart Qoder AI completely
+4. Check Qoder AI logs for errors
 
-**Protocol:** MCP (STDIO) | **Setup Time:** 3 minutes | **Auto-Start:** ✅ Yes
+**Problem 3: "Browser not opening"**
 
-**✅ Good News:** Qoder AI supports standard STDIO-based MCP servers (just like Claude, Cursor, Windsurf)!
-
-#### 📋 Step-by-Step Setup Guide:
+**Solution:**
+```bash
+# Set Brave path explicitly in config
+"env": {
+  "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+}
+```
 
-**Step 1: Open Qoder Settings**
+**Problem 4: "SSE server not connecting"**
 
+**Solution:**
 ```bash
-# Method 1: Using keyboard shortcut
-# Windows: Ctrl + Shift + ,
-# Mac: ⌘ + Shift + ,
+# Check if server is running
+curl http://localhost:3001/health
 
-# Method 2: Click user icon in upper-right corner
-# Then select "Qoder Settings"
+# Try different port
+npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3002
 ```
 
-**Step 2: Navigate to MCP Section**
+---
 
-1. In left-side navigation pane, click **MCP**
-2. Click on **My Servers** tab
-3. Click **+ Add** button in upper-right corner
+### 📊 Available Tools in Qoder AI
 
-**Step 3: Install Package Globally (Important for Qoder AI)**
+All **111 tools** are available:
 
-```bash
-# Install globally for faster startup
-npm install -g brave-real-browser-mcp-server@latest
+✅ **Browser Management:** `browser_init`, `browser_close`  
+✅ **Navigation:** `navigate`, `wait`, `click`, `type`  
+✅ **Content Extraction:** `get_content`, `scrape_table`, `extract_json`, `scrape_meta_tags`  
+✅ **Media Tools:** `video_link_finder`, `image_scraper`, `media_extractor`  
+✅ **CAPTCHA Solving:** `solve_captcha`, `ocr_engine`  
+✅ **Data Processing:** `price_parser`, `date_normalizer`, `contact_extractor`  
+✅ **Visual Tools:** `full_page_screenshot`, `pdf_generation`  
+✅ **And 90+ more tools!**
 
-# Verify installation
-where brave-real-browser-mcp-server  # Windows
-which brave-real-browser-mcp-server  # Mac/Linux
-```
+---
+
+## 🎨 IDE Configurations
 
-**Why global install?** Qoder AI has a short timeout for MCP server initialization. Using `npx` can be slow on first run. Global installation ensures fast startup.
 
-**Step 4: Add Configuration**
+**Step 2: Add Configuration**
 
-A JSON file will appear. Add this configuration:
+Copy and paste this configuration:
 
-**Option A - Using Global Install (Recommended):**
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
-      "command": "brave-real-browser-mcp-server",
-      "args": []
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Option B - Using NPX (May timeout on first run):**
+**Advanced Configuration (Optional):**
+
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
       "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
+        "HEADLESS": "false"
+      }
     }
   }
 }
 ```
 
-**Option C - Using Node directly:**
-```json
-{
+**Configuration Locations:**
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+### Cursor AI
+
+**Step 3: Add Configuration**
+
+**Basic Configuration:**
+```json
+{
   "mcpServers": {
     "brave-real-browser": {
-      "command": "node",
-      "args": [
-        "C:\\Users\\Admin\\AppData\\Roaming\\npm\\node_modules\\brave-real-browser-mcp-server\\dist\\index.js"
-      ]
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Note:** Replace path in Option C with your actual global npm modules path:
-- Windows: `%APPDATA%\npm\node_modules\brave-real-browser-mcp-server\dist\index.js`
-- Mac/Linux: `/usr/local/lib/node_modules/brave-real-browser-mcp-server/dist/index.js`
-
-**Advanced Configuration (with environment variables):**
-
+**Advanced Configuration (with Brave path):**
 ```json
 {
   "mcpServers": {
@@ -739,7 +741,6 @@ A JSON file will appear. Add this configuration:
 ```
 
 **For Mac:**
-
 ```json
 {
   "mcpServers": {
@@ -754,180 +755,147 @@ A JSON file will appear. Add this configuration:
 }
 ```
 
-**Step 5: Save Configuration**
-
-1. Close the JSON file
-2. Click **Save** when prompted
-3. The new server will appear in your list
-4. A **link icon** (🔗) means the connection is successful
-
-**Step 6: Verify Installation**
-
-1. Expand the **brave-real-browser** entry
-2. You should see list of 111 available tools
-3. If server fails to start, click **Quick Fix** button
-4. If issue persists, check troubleshooting section below
-
-**Step 7: Using Tools in Qoder AI**
-
-1. Switch to **Agent mode** in AI Chat panel
-2. Ask Qoder to use browser automation:
-   ```
-   Use brave-real-browser to navigate to https://example.com and extract the main content
-   ```
-3. Qoder will prompt for confirmation before using MCP tools
-4. Press `Ctrl+Enter` (Windows) or `⌘+Enter` (Mac) to execute
-
-**Important Notes:**
-
-- ⚠️ **Maximum 10 MCP servers** can be used simultaneously
-- ✅ **Only works in Agent mode** (not in Ask mode)
-- ✅ **Server auto-starts** when Qoder launches
-- ✅ **Node.js V18+ required** (includes NPM V8+)
-
-**Prerequisites Check:**
-
-```bash
-# Verify Node.js installation
-node -v  # Should show v18.0.0 or higher
-npx -v   # Should show version number
-
-# If not installed:
-# Windows: Download from https://nodejs.org/
-# Mac: brew install node
-# Linux: Use package manager (apt, yum, etc.)
-```
-
-**Troubleshooting:**
-
-**Issue: "context deadline exceeded" or Timeout Error**
+### Windsurf
 
-```
-failed to initialize MCP client: context deadline exceeded
-```
+**File:** `mcp.json`
 
-**Cause:** Qoder AI has a short initialization timeout. Using `npx` can be slow on first run because it needs to download and cache the package.
+**Location:**
 
-**Solution 1 - Install Globally (Recommended):**
-```bash
-# Install package globally for instant startup
-npm install -g brave-real-browser-mcp-server@latest
-```
+- Windows: `%APPDATA%\Windsurf\mcp.json`
+- Mac: `~/.windsurf/mcp.json`
 
-Then update your configuration to:
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
-      "command": "brave-real-browser-mcp-server",
-      "args": []
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Solution 2 - Pre-cache npx package:**
-```bash
-# Run once to cache the package
-npx -y brave-real-browser-mcp-server@latest
-# Press Ctrl+C after server starts
-
-# Now npx will be fast on subsequent runs
-```
+### Cline (VSCode Extension)
 
-**Solution 3 - Use Direct Node Path:**
+**File:** `cline_mcp_settings.json`
 
-First, find the global package location:
-```bash
-# Windows
-npm root -g
-# Usually: C:\Users\<USERNAME>\AppData\Roaming\npm\node_modules
+**Location:**
 
-# Mac/Linux  
-npm root -g
-# Usually: /usr/local/lib/node_modules
-```
+- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+- Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
 
-Then use full path:
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
-      "command": "node",
-      "args": ["<npm-root>\\brave-real-browser-mcp-server\\dist\\index.js"]
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Issue: "exec: npx: executable file not found"**
+### Zed Editor
 
-```bash
-# Solution: Install Node.js V18 or later
-# Windows
-nvm install 22.14.0
-nvm use 22.14.0
+**Protocol:** Context Servers (MCP)
 
-# Mac
-brew install node
+**File:** `settings.json`
 
-# Verify
-node -v
-npx -v
-```
+**Location:**
 
-**Issue: "failed to initialize MCP client: context deadline exceeded"**
+- Windows: `%APPDATA%\Zed\settings.json`
+- Mac: `~/.config/zed/settings.json`
+- Linux: `~/.config/zed/settings.json`
 
-1. Click **Copy complete command** in Qoder UI
-2. Run command in terminal to see detailed error
-3. Check if Node.js is blocked by security software
-4. Add Node.js to security software whitelist
+#### Step-by-Step Setup Guide:
 
-**Issue: Server fails to connect**
+**Step 1:** Open Zed Editor and press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (Mac)
 
-1. Click **Retry** icon in Qoder interface
-2. Qoder will attempt to restart MCP server automatically
-3. Check **My Servers** tab for connection status
-4. Expand server details to see tools list
+**Step 2:** Type "Open Settings" and select "Zed: Open Settings"
 
-**Issue: Tools not being called by LLM**
+**Step 3:** Add the following configuration:
 
-1. Make sure you're in **Agent mode** (not Ask mode)
-2. Open a project directory in Qoder
-3. Ensure MCP server shows **link icon** (connected)
-4. Try explicit prompt: "Use brave-real-browser to..."
+```json
+{
+  "context_servers": {
+    "brave-real-browser": {
+      "source": "custom",
+      "command": "npx.cmd",
+      "args": ["-y", "brave-real-browser-mcp-server"]
+    }
+  }
+}
+```
 
-**Configuration Locations:**
+**For Mac/Linux, use:**
+```json
+{
+  "context_servers": {
+    "brave-real-browser": {
+      "source": "custom",
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server"]
+    }
+  }
+}
+```
 
-- Windows: Qoder Settings → MCP → My Servers
-- Mac: Qoder Settings → MCP → My Servers
-- Linux: Qoder Settings → MCP → My Servers
+**Note:** Replace path in Option C with your actual global npm modules path:
+- Windows: `%APPDATA%\npm\node_modules\brave-real-browser-mcp-server\dist\index.js`
+- Mac/Linux: `/usr/local/lib/node_modules/brave-real-browser-mcp-server/dist/index.js`
 
-**Official Documentation:**
-- Qoder MCP Guide: https://docs.qoder.com/user-guide/chat/model-context-protocol
-- MCP Common Issues: https://docs.qoder.com/support/mcp-common-issues
+**Advanced Configuration (with environment variables):**
 
-### Other HTTP-based IDEs (Gemini CLI, Qwen Code CLI, Custom Tools)
+```json
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
+        "HEADLESS": "false"
+      }
+    }
+  }
+}
+```
 
-**Step 1:** Start HTTP server as shown above
+**For Mac:**
 
-**Step 2:** Configure your IDE/tool to use endpoint: `http://localhost:3000`
+```json
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+      }
+    }
+  }
+}
+```
 
-**Step 3:** Make HTTP POST requests to execute tools:
+**Cause:** Qoder AI has a short initialization timeout. Using `npx` can be slow on first run because it needs to download and cache the package.
 
+**Solution 1 - Install Globally (Recommended):**
 ```bash
-# Example: Navigate to URL
-curl -X POST http://localhost:3000/tools/navigate \
-  -H "Content-Type: application/json" \
-  -d '{"url": "https://example.com"}'
-
-# Example: Get page content
-curl -X POST http://localhost:3000/tools/get_content \
-  -H "Content-Type: application/json" \
-  -d '{"type": "text"}'
+# Install package globally for instant startup
+npm install -g brave-real-browser-mcp-server@latest
 ```
 
----
+Then update your configuration to:
+```json
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "brave-real-browser-mcp-server",
+      "args": []
+    }
+  }
+}
+```
 
 ## 🛠️ Available Tools (111)
 
@@ -1133,131 +1101,6 @@ curl -X POST http://localhost:3000/tools/get_content \
 | `url_redirect_tracer`        | Trace URL redirects         |
 | `user_agent_extractor`       | Extract user agent info     |
 
----
-
-## 💡 Usage Examples
-
-### Example 1: Simple Web Scraping (MCP Mode)
-
-```javascript
-// Using MCP tool in Claude/Cursor
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "browser_init",
-  arguments: {},
-});
-
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "navigate",
-  arguments: { url: "https://example.com" },
-});
-
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "get_content",
-  arguments: { type: "text" },
-});
-```
-
-### Example 2: CAPTCHA Solving
-
-```javascript
-// Navigate to CAPTCHA page
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "navigate",
-  arguments: { url: "https://site-with-captcha.com" },
-});
-
-// Solve CAPTCHA
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "solve_captcha",
-  arguments: { type: "recaptcha" },
-});
-
-// Continue automation
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "click",
-  arguments: { selector: "button.submit" },
-});
-```
-
-### Example 3: Video Extraction
-
-```javascript
-// Navigate to video page
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "navigate",
-  arguments: { url: "https://video-site.com/video/123" },
-});
-
-// Find video links
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "video_link_finder",
-  arguments: {},
-});
-
-// Advanced video extraction with ad bypass
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "advanced_video_extraction",
-  arguments: {},
-});
-```
-
-### Example 4: Multi-Page Scraping
-
-```javascript
-// Initialize browser
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "browser_init",
-  arguments: {},
-});
-
-// Auto-paginate through all pages
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "multi_page_scraper",
-  arguments: {
-    startUrl: "https://example.com/page/1",
-    maxPages: 10,
-  },
-});
-```
-
----
-
-## 📋 API Endpoints (HTTP Mode)
-
-When running in HTTP mode, these endpoints are available:
-
-```
-GET  /health                    - Health check
-GET  /tools                     - List all tools
-POST /tools/:toolName           - Execute any tool
-POST /browser/init              - Initialize browser
-POST /browser/navigate          - Navigate to URL
-POST /browser/get_content       - Get page content
-POST /browser/click             - Click element
-POST /browser/type              - Type text
-POST /browser/close             - Close browser
-```
-
-**Example:**
-
-```bash
-curl -X POST http://localhost:3000/tools/navigate \
-  -H "Content-Type: application/json" \
-  -d '{"url": "https://example.com"}'
-```
-
----
 
 ## 🔧 Environment Variables
 
@@ -1275,403 +1118,6 @@ DISABLE_CONTENT_PRIORITY=true
 HTTP_PORT=3000
 ```
 
----
-
-## 🐛 Troubleshooting
-
-### Common Issues & Solutions
-
-#### 1. Brave Browser Not Found
-
-**Symptoms:**
-- Error: "Brave browser not found"
-- Browser fails to launch
-
-**Solutions:**
-
-```bash
-# Windows (PowerShell)
-$env:BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
-
-# Windows (CMD)
-set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
-
-# Mac
-export BRAVE_PATH="/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
-
-# Linux (Ubuntu/Debian)
-export BRAVE_PATH="/usr/bin/brave-browser"
-
-# Linux (Snap)
-export BRAVE_PATH="/snap/bin/brave"
-```
-
-**Permanent Fix (Windows):**
-```powershell
-# Add to System Environment Variables
-[System.Environment]::SetEnvironmentVariable('BRAVE_PATH', 'C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe', 'User')
-```
-
----
-
-#### 2. Server Won't Start
-
-**Symptoms:**
-- "Failed to start server" error
-- Process exits immediately
-- No output in terminal
-
-**Solutions:**
-
-**Step 1:** Check Node.js version
-```bash
-node --version
-# Should show v18.0.0 or higher
-```
-
-**Step 2:** If Node.js is old, update it:
-```bash
-# Windows (using Chocolatey)
-choco upgrade nodejs
-
-# Mac (using Homebrew)
-brew upgrade node
-
-# Or download from: https://nodejs.org/
-```
-
-**Step 3:** Clear npm cache and reinstall
-```bash
-npm cache clean --force
-npm uninstall -g brave-real-browser-mcp-server
-npm install -g brave-real-browser-mcp-server@latest
-```
-
-**Step 4:** Check for conflicting processes
-```bash
-# Windows
-taskkill /F /IM brave.exe
-
-# Mac/Linux
-pkill -f brave
-```
-
----
-
-#### 3. Port Already in Use (HTTP Mode)
-
-**Symptoms:**
-- Error: "EADDRINUSE: address already in use ::3000"
-- HTTP server fails to start
-
-**Solutions:**
-
-**Option A:** Use a different port
-```bash
-npx brave-real-browser-mcp-server@latest --mode http --port 8080
-```
-
-**Option B:** Kill the process using port 3000
-
-```bash
-# Windows (PowerShell)
-Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess | Stop-Process -Force
-
-# Windows (CMD)
-for /f "tokens=5" %a in ('netstat -aon ^| find ":3000" ^| find "LISTENING"') do taskkill /F /PID %a
-
-# Mac/Linux
-lsof -ti:3000 | xargs kill -9
-```
-
----
-
-#### 4. Qoder AI Configuration Fails
-
-**Symptoms:**
-- "Connection refused" error
-- "Server not reachable" message
-- Tools not appearing in Qoder AI
-
-**Solutions:**
-
-**Step 1:** Verify HTTP server is running
-```bash
-# Start server in a separate terminal
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
-
-# You should see:
-# ✅ [HTTP] Server ready at http://localhost:3000
-```
-
-**Step 2:** Test server connection
-```bash
-curl http://localhost:3000/health
-# Expected: {"status":"ok","timestamp":"..."}
-```
-
-**Step 3:** Check firewall settings
-```bash
-# Windows: Allow Node.js through firewall
-netsh advfirewall firewall add rule name="Node.js" dir=in action=allow program="C:\Program Files\nodejs\node.exe" enable=yes
-```
-
-**Step 4:** Try alternative configuration
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest", "--mode", "http", "--port", "3000"],
-      "env": {}
-    }
-  }
-}
-```
-
----
-
-#### 5. Zed Editor Not Detecting Server
-
-**Symptoms:**
-- Context servers not appearing
-- "Failed to start context server" error
-
-**Solutions:**
-
-**Step 1:** Ensure Zed Preview version
-```bash
-# Check Zed version (should be v0.120.0 or higher)
-# Open Zed → Help → About Zed
-```
-
-**Step 2:** Verify correct configuration format
-```json
-{
-  "context_servers": {
-    "brave-real-browser": {
-      "source": "custom",
-      "command": "npx.cmd",  // Windows: use npx.cmd, Mac/Linux: use npx
-      "args": ["-y", "brave-real-browser-mcp-server"]
-    }
-  }
-}
-```
-
-**Step 3:** Check Zed logs
-```bash
-# Open Zed → View → Debug → Language Server Logs
-# Look for error messages
-```
-
-**Step 4:** Restart Zed completely
-```bash
-# Close Zed and kill any background processes
-# Windows
-taskkill /F /IM zed.exe
-
-# Mac
-pkill -f zed
-```
-
----
-
-#### 6. Claude Desktop Configuration Issues
-
-**Symptoms:**
-- "MCP server failed to start"
-- Tools not appearing in Claude
-
-**Solutions:**
-
-**Step 1:** Check config file location
-```bash
-# Windows
-echo %APPDATA%\Claude\claude_desktop_config.json
-
-# Mac
-echo ~/Library/Application\ Support/Claude/claude_desktop_config.json
-```
-
-**Step 2:** Validate JSON format
-- Use https://jsonlint.com/ to validate your config
-- Ensure no trailing commas
-- Check quotes are properly escaped
-
-**Step 3:** Check Claude logs
-```bash
-# Windows
-type "%APPDATA%\Claude\logs\mcp*.log"
-
-# Mac
-cat ~/Library/Logs/Claude/mcp*.log
-```
-
-**Step 4:** Restart Claude Desktop completely
-```bash
-# Windows
-taskkill /F /IM claude.exe
-
-# Mac
-pkill -f Claude
-```
-
----
-
-#### 7. CAPTCHA Not Solving
-
-**Symptoms:**
-- CAPTCHA solve timeout
-- "Failed to solve CAPTCHA" error
-
-**Solutions:**
-
-**Step 1:** Ensure CAPTCHA is fully loaded
-```javascript
-// Add wait before solving
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "wait",
-  arguments: { type: "timeout", value: "5000" }
-});
-```
-
-**Step 2:** Try longer timeout
-```javascript
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "solve_captcha",
-  arguments: { 
-    type: "recaptcha",
-    timeout: 60000  // 60 seconds
-  }
-});
-```
-
-**Step 3:** Try different CAPTCHA types
-- `recaptcha` - Google reCAPTCHA v2/v3
-- `hcaptcha` - hCaptcha
-- `turnstile` - Cloudflare Turnstile
-
----
-
-#### 8. NPX Command Not Found
-
-**Symptoms:**
-- "npx: command not found"
-- "npx is not recognized"
-
-**Solutions:**
-
-**Step 1:** Verify npm installation
-```bash
-npm --version
-```
-
-**Step 2:** Reinstall Node.js
-- Download from: https://nodejs.org/
-- Choose LTS version
-- During installation, ensure "Add to PATH" is checked
-
-**Step 3:** Add npm to PATH manually (Windows)
-```powershell
-$env:PATH += ";C:\Program Files\nodejs"
-```
-
----
-
-#### 9. Permission Denied Errors (Linux/Mac)
-
-**Symptoms:**
-- "EACCES: permission denied"
-- Cannot install globally
-
-**Solutions:**
-
-```bash
-# Option A: Fix npm permissions
-sudo chown -R $(whoami) ~/.npm
-sudo chown -R $(whoami) /usr/local/lib/node_modules
-
-# Option B: Use npx instead of global install
-npx brave-real-browser-mcp-server@latest
-
-# Option C: Use nvm (recommended)
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
-nvm install --lts
-```
-
----
-
-#### 10. Browser Crashes or Hangs
-
-**Symptoms:**
-- Browser becomes unresponsive
-- "Page crashed" errors
-- Memory issues
-
-**Solutions:**
-
-**Step 1:** Enable headless mode
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "HEADLESS": "true"
-      }
-    }
-  }
-}
-```
-
-**Step 2:** Increase timeout values
-```javascript
-await use_mcp_tool({
-  server_name: "brave-real-browser",
-  tool_name: "navigate",
-  arguments: { 
-    url: "https://example.com",
-    waitUntil: "networkidle2",
-    timeout: 60000
-  }
-});
-```
-
-**Step 3:** Clear browser cache
-```bash
-# Kill all Brave processes
-# Windows
-taskkill /F /IM brave.exe
-
-# Mac/Linux
-pkill -9 brave
-```
-
----
-
-### Getting Help
-
-If you're still experiencing issues:
-
-1. **Check GitHub Issues:** https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues
-2. **Enable Debug Logs:** Set `DEBUG=*` environment variable
-3. **Report Bug:** Include:
-   - Operating System & version
-   - Node.js version (`node --version`)
-   - Editor/IDE name & version
-   - Complete error message
-   - Configuration file (remove sensitive data)
-
-```bash
-# Run with debug logging
-DEBUG=* npx brave-real-browser-mcp-server@latest --mode http
-```
-
----
-
 ## 📊 Supported Protocols
 
 || Protocol        | Used By                                       | Auto-Config | Status     |
@@ -1682,46 +1128,6 @@ DEBUG=* npx brave-real-browser-mcp-server@latest --mode http
 || **WebSocket**   | Modern Web Apps, Real-time Tools              | ✅          | 🟢 Working |
 || **SSE**         | Real-time Streaming, Web Apps                 | ✅          | 🟢 Working |
 
----
-
-## 📊 Editor Compatibility Matrix
-
-| AI Editor | Protocol | Config File | Server Auto-Start | HTTP Server Required | Status |
-|-----------|----------|-------------|-------------------|----------------------|--------|
-| **Claude Desktop** | MCP | `claude_desktop_config.json` | ✅ Yes | ❌ No | 🟢 Working |
-| **Cursor AI** | MCP | `cline_mcp_settings.json` | ✅ Yes | ❌ No | 🟢 Working |
-| **Windsurf** | MCP | `mcp.json` | ✅ Yes | ❌ No | 🟢 Working |
-| **Cline (VSCode)** | MCP | `cline_mcp_settings.json` | ✅ Yes | ❌ No | 🟢 Working |
-| **Warp Terminal** | MCP | Warp config | ✅ Yes | ❌ No | 🟢 Working |
-| **Zed Editor** | Context Servers (MCP) | `settings.json` | ✅ Yes | ❌ No | 🟢 Working |
-| **Qoder AI** | HTTP | `mcp.json` or config | ❌ No | ✅ **Yes** | 🟢 Working |
-| **Gemini CLI** | HTTP | CLI config | ❌ No | ✅ **Yes** | 🟢 Working |
-| **Qwen Code CLI** | HTTP | CLI config | ❌ No | ✅ **Yes** | 🟢 Working |
-| **Continue.dev** | HTTP | Extension config | ❌ No | ✅ **Yes** | 🟢 Working |
-| **Custom Tools** | HTTP | API integration | ❌ No | ✅ **Yes** | 🟢 Working |
-| **VSCode (Generic)** | LSP/HTTP | Extension config | Varies | Optional | 🟢 Working |
-
-**Legend:**
-- ✅ **Server Auto-Start**: Editor automatically starts the MCP server
-- ❌ **HTTP Server Required**: You must manually start HTTP server before using
-- 🟢 **Working**: Fully tested and operational
-
----
-
-## 📋 Requirements
-
-- **Node.js** >= 18.0.0
-- **Brave Browser** (auto-detected or specify path)
-- **Operating System:** Windows, macOS, Linux
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please submit a Pull Request.
-
----
-
 ## 📄 License
 
 MIT License - See LICENSE file for details.
@@ -1742,7 +1148,3 @@ MIT License - See LICENSE file for details.
 
 **Made with ❤️ for the AI Development Community**
 
-[⭐ Star on GitHub](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server) | [🐛 Report Bug](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues) | [💡 Request Feature](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues)
-
-</div>
-| **MCP (STDIO)** | Claude Desktop,