v0.1.8 — now with session persistence

    Reliable browser
    infrastructure.

    Reliable & scalable browser infrastructure for AI agents and automation.

    $npx browser-gateway serve

    Starts the gateway, dashboard, and MCP server on one port

    browser-gateway dashboard
    Any Provider

    Browserless, Steel, Chrome, Docker

    Auto Failover

    Zero downtime, zero code changes

    One Endpoint

    Route all connections through one URL

    MIT Licensed

    Open source and free

    Connect once. We route to what's available.

    AI Agents
    Applications
    Automation

    browser-gateway

    2 req/s
    Routing
    Failover
    Health Checks
    Queuing
    Sessions
    P1

    Cloud CDP

    Load2/12
    P2

    Docker

    Load0/8
    P3

    Local Chrome

    Load0/5

    Works with everything

    Drop-in compatible

    Change one line. Get routing, failover, and pooling for free.

    app.ts
    import { chromium } from "playwright-core";
    
    // One line change — route through the gateway
    const browser = await chromium.connectOverCDP(
      "http://localhost:9500"
    );
    
    const page = await browser.newPage();
    await page.goto("https://example.com");
    console.log(await page.title());
    await browser.close();

    Drop-in replacement. Change the URL, keep everything else.

    Built for AI agents

    Give every agent
    a browser.
    No setup required.

    The built-in MCP server auto-detects Chrome on your system, launches it on first use, and gives AI agents 8 browser tools through the gateway's routing layer.

    Works with Claude Code, Cursor, and any MCP client
    Each agent session gets its own browser instance
    Headed on desktop, headless in Docker/CI automatically
    Routes through multi-provider gateway for failover
    MCP documentation
    8 Browser Tools
    browser_navigateGo to a URL
    browser_snapshotAccessibility tree with refs
    browser_screenshotCapture page as PNG
    browser_interactClick, type, scroll
    browser_evaluateRun JavaScript
    browser_set_viewportResize viewport
    browser_closeEnd session
    browser_statusGateway health

    Features

    Everything you need to route browsers

    5 Routing Strategies

    Priority chain, round-robin, least-connections, latency-optimized, and weighted distribution.

    Automatic Failover

    Provider goes down? Next one picks up instantly. TTL-based cooldowns with auto-recovery.

    MCP Server

    8 browser tools for AI agents. Navigate, screenshot, snapshot, interact, evaluate. Zero config.

    Request Queue

    All providers busy? Connections wait in a FIFO queue instead of failing. Configurable timeouts.

    Concurrency Limits

    Set maxConcurrent per provider. The gateway enforces it so providers never get overwhelmed.

    Session Persistence

    Disconnect and reconnect to the same browser. Cookies, localStorage, and page state preserved.

    Web Dashboard

    Manage providers, view live sessions, edit config, monitor health — all from the browser.

    Health Monitoring

    Periodic connectivity probes detect unhealthy providers. Cooldown system skips failing ones.

    Webhooks

    Get notified when providers go down, recover, enter cooldown, or when the queue overflows.

    Protocol Agnostic

    Works with CDP, Playwright protocol, WebDriver BiDi — raw TCP pipe forwards any WebSocket protocol.

    Developer experience

    From zero to routing in seconds

    terminal
    $ npx browser-gateway serve
    ┌─────────────────────────────────────────┐
    browser-gateway v0.1.8
    └─────────────────────────────────────────┘
    + Config loaded gateway.yml
    + Provider cloud-cdp healthy (5 slots)
    + Provider docker-pw healthy (10 slots)
    + Provider local-chrome healthy (2 slots)
    > Gateway ws://localhost:9500
    > Dashboard http://localhost:9500/web
    > MCP http://localhost:9500/mcp
    > Strategy priority-chain
    Waiting for connections...|
    Open source

    Built in the open.
    MIT licensed.

    No vendor lock-in. Fork it, self-host it, extend it. Your infrastructure, your rules.

    browser-gateway serve

    Start gateway + dashboard

    browser-gateway mcp

    MCP server for agents

    browser-gateway check

    Test provider health