Windsurf browser MCP setup

Connect E2LLM to Windsurf

Give Windsurf access to the browser session you already use. E2LLM connects as a remote MCP server, so Windsurf can read the rendered page, inspect controls, and act through explicit browser tools.

Remote MCPStreamable HTTPOAuthCascade

Ready-made setup instruction

Paste this into Cascade. It preserves the current MCP set and adds E2LLM as a remote HTTP server.

Configure E2LLM as a remote HTTP MCP server in Windsurf.

1. Read ~/.codeium/windsurf/mcp_config.json. Preserve every existing server and setting.
2. Under "mcpServers", add:
   "e2llm": {
     "serverUrl": "https://mcp.e2llm.com/mcp"
   }
3. Keep the file valid JSON and retain unrelated entries.
4. Ask me to open Windsurf Settings > Cascade > MCP Servers, enable e2llm, and complete OAuth.
5. Wait for the E2LLM tools to appear, then ask me to run the verification prompt from this page.

Windsurf stores its MCP server list in ~/.codeium/windsurf/mcp_config.json.

Connect

Connect your browser

Use the E2LLM setup wizard to install the browser extension and sign in.

Add E2LLM to Cascade

Open Windsurf Settings, Cascade, MCP Servers. Add the endpoint through the UI or raw configuration:

{
  "mcpServers": {
    "e2llm": {
      "serverUrl": "https://mcp.e2llm.com/mcp"
    }
  }
}

Enable tools and authorize

Enable the E2LLM tools in Cascade's MCP settings and complete OAuth with the extension's E2LLM account.

Official client mechanics: Windsurf supports Streamable HTTP, OAuth, remote server URLs, and raw configuration in mcp_config.json. Read Windsurf's MCP documentation →

Verify the connection

Confirm that Windsurf lists the E2LLM tools. Open a normal webpage in the connected browser and run this read-only check:

Use E2LLM to list my open browser tabs. Then capture the active tab and tell me its page title and primary heading. Keep the page unchanged.

Pass condition: Windsurf returns the tabs, captures the active page, and reports details from that page through real tool calls.

Worked use case

Repair a responsive layout from the live narrow viewport

Cascade can trace styles through the repository while E2LLM captures the actual narrow layout, occlusion, and interactive controls.

Fix the responsive layout issue in my active application tab.

1. Use E2LLM to capture the active tab at its current viewport.
2. Identify the clipped, overlapping, or hidden high-salience controls.
3. Trace those elements to their components and styles in this repository.
4. Apply the smallest responsive CSS or component fix.
5. Ask me to reload, recapture the same tab, and verify the controls are visible and usable.

Keep the browser unchanged until the reload I perform.

This workflow gives Cascade concrete rendered geometry for a bug that source inspection alone cannot reproduce reliably.

Troubleshoot the connection

E2LLM is absent: validate ~/.codeium/windsurf/mcp_config.json and confirm the entry sits inside mcpServers.
The server stays disabled: open Cascade's MCP settings and enable its tools.
OAuth needs another attempt: restart the server from MCP settings and complete the browser flow.
No tabs appear: confirm the browser extension is connected with the same account.
Enterprise policy blocks it: ask the team administrator to allow the exact e2llm entry.

Capabilities

E2LLM exposes the tools advertised by the running production deployment: structured page capture, targeted reads, tab discovery, exploration, and explicit browser actions. The generated MCP tool reference is built from that named production deployment and stays aligned with what it advertises.