v0.2.1Open source MCP server · MIT

A browser hive
for your agents.

Isolated, stealthy Chromium sessions for any MCP client, with password logins the model never sees, human takeover when it gets stuck and a replayable audit trail. Everything runs on your machine.

bun add -g browserhive
Works with any MCP client
  • Claude Code
  • Claude Desktop
  • Cursor
  • VS Code
  • Streamable HTTP
  • stdio

Why BrowserHive

Agents that browse need more than a headless browser.

  • They run in parallel and must not leak cookies or logins into each other.
  • Websites push back. A bare automation browser announces itself.
  • They need to log in, and a password in the prompt is a password in the transcript.
  • They get stuck on CAPTCHAs, 2FA prompts and judgment calls.
  • You need to see what they did, after the fact and live.

What you get

43 MCP tools. One local server.
Every hard part handled.

  • OpenTelemetry

    Opt-in OTLP traces, metrics and logs to any collector.

  • Guardrails

    URL blocklist with hot reload, launch-argument deny-list, per-session ownership.

  • Operator dashboard

    Sessions with live view, attention queue, vault log, logs and effective config.

  • Notifications on your phone

    Your own Telegram, Discord or ntfy. Approve or resolve from the chat, plus daily digests.

  • Your browser, sandboxed

    Bundled Chromium or your installed Chrome or Edge, inside Chromium's sandbox where the host allows.

  • Knows your agents

    Recognises Claude Code, Codex, Cursor and more; sessions and tool calls per agent.

Quick start

From zero to a browsing agent in three commands.

  1. 1

    Install

    Requires Bun 1.4 or newer. Installing with npm or pnpm works too.

    bun add -g browserhive
  2. 2

    Initialize

    Downloads Chromium, creates the data directory and checks the host.

    browserhive init
  3. 3

    Run and connect

    MCP and the dashboard share one port. The first start prints a one-time dashboard password.

    browserhive --admin
All client setups
claude mcp add --transport http browserhive http://127.0.0.1:9876/mcp
then ask your agent: “launch a session and open example.com”
  • 43MCP tools with a frozen contract
  • 1port for MCP, API, WebSocket and dashboard
  • 0bytes leave your machine until you turn on telemetry or notifications
  • MITlicensed, specified before it is coded

Give your agents a browser you can trust.

Install in a minute. Read the security model before you expose anything beyond localhost.