Browser Gateway
Chrome browser tools for agents, with failover across cloud browser providers
- 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-gatewayAdd 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.



