Skip to content
MCP server

Browser Gateway

Chrome browser tools for agents, with failover across cloud browser providers

Runs locallyStatus and history
Install
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.4.36
Listing updated
today

Similar MCP servers

About Browser Gateway

Browser Gateway is an MCP server for browser automation. It runs locally on your machine and is started by your AI client.

The npm package works two ways. As a gateway it gives your app one WebSocket endpoint that routes to cloud CDP services, Docker containers or local Chrome, using priority, round-robin, least-connections, latency or weighted strategies, with queueing, cooldowns, health checks and automatic failover. As an MCP server it gives agents browser tools that need no Playwright or Puppeteer dependency and auto-launch Chrome on first use.

The MCP side has two one-call tools, fetch_page (a URL as markdown) and screenshot_page, plus session tools for navigating, snapshotting, acting, extracting, waiting, tabs, evaluating and observing. A Claude Code plugin sends Claude to fetch_page when built-in web fetch is blocked, empty or needs JavaScript.

Other parts include encrypted persistent profiles that restore cookies and localStorage, frame-accurate session replays, a REST API for screenshots, content and scraping, and a dashboard at localhost:9500/web. BG_TOKEN is only needed with remote providers.

Install

Run in a terminal

claude mcp add browser-gateway --env BG_TOKEN='<BG_TOKEN>' -- npx -y browser-gateway

Add to claude_desktop_config.json

{
  "mcpServers": {
    "browser-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "browser-gateway"
      ],
      "env": {
        "BG_TOKEN": "<BG_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "browser-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "browser-gateway"
      ],
      "env": {
        "BG_TOKEN": "<BG_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "browser-gateway": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "browser-gateway"
      ],
      "env": {
        "BG_TOKEN": "<BG_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "browser-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "browser-gateway"
      ],
      "env": {
        "BG_TOKEN": "<BG_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "browser-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "browser-gateway"
      ],
      "env": {
        "BG_TOKEN": "<BG_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BG_TOKENAuthentication token for gateway access (optional, only needed with remote providers)

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

fetch_page
Read a URL as markdown in a single call
screenshot_page
Capture a URL in a single call
browser_session
Start a browser session
browser_navigate
Navigate the browser
browser_snapshot
Take a page snapshot
browser_act
Perform an action on the page
browser_extract
Extract data from the page
browser_screenshot
Take a screenshot in a session
browser_wait
Wait for a condition
browser_tabs
Manage tabs
browser_evaluate
Evaluate script in the page
browser_observe
Observe the page

What it does

Provider failover
Routes across browser providers and switches when one fails.
Agent browser tools
MCP tools for fetching, screenshots, navigation, actions and extraction.
Persistent profiles
Encrypted cookies and localStorage replay across sessions.
Session replay
Frame-accurate recordings of routed sessions.
REST API
Screenshot, content and scrape endpoints.
Computer-use loops
Helpers for Claude and Gemini computer use on any provider.

Good for

  • Give a coding agent a fallback for blocked web fetches
  • Spread browser sessions across several cloud providers
  • Keep a logged-in profile between agent runs
  • Replay what an agent saw during a session

Pricing

Pricing unknown

Install from npm; licence and hosted pricing are not published

Browser Gateway FAQ

Does it need Playwright?

The MCP tools use raw CDP with no Playwright or Puppeteer dependency.

Is a token required?

BG_TOKEN is optional and only needed with remote providers.

What clients work?

Claude Code, Cursor and any MCP-compatible client.

How are profiles protected?

They are encrypted at rest with AES-256-GCM.

How do I add Browser Gateway to Claude Code?

Run this command in your terminal: claude mcp add browser-gateway --env BG_TOKEN='<BG_TOKEN>' -- npx -y browser-gateway

What are the best alternatives to Browser Gateway?

The closest alternatives to Browser Gateway are Browser Use, Scrapling MCP Server, Chrome DevTools MCP, Firecrawl MCP Server and Douyin_TikTok_Download_API.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers