What it does
Agent Browser runs a single headed Chrome session on a self-hosted server. An agent drives it through a small JSON API, while a live noVNC view of the same session lets a person watch and step in. The runtime combines Xvfb, x11vnc, noVNC and the API, and the browser reports bounded page text, accessibility state and screenshots.
It suits agents that hit a login, payment or 2FA prompt they cannot answer. Any MCP client, including Claude Code, Claude Desktop, Cursor and Windsurf, can use its nine browser tools, and the server asks the model to request a takeover at those points. Node/TypeScript and Python clients offer the same API, with helpers that always end the session. An optional Python layer, Jev, lets a selected model choose between caller-approved URLs, a handoff, or human takeover.
Setup is one Docker Compose command on Docker Engine for Linux with Compose v2, which builds from the source checkout; the first build takes several minutes. The live view is served on loopback, and local loopback calls need no bearer token. The Node client includes a doctor command and an up command for starting the runtime on Linux.
Limitations and requirements
Requires Docker Engine on Linux with Compose v2 and host networking; Docker Desktop and remote-host deployment are outside the quickstart. The first build takes several minutes, and rebuilding may pick up a newer Chrome Stable. The v0.x noVNC surface is unauthenticated and kept on loopback. The Python client needs Python 3.10 or newer. The optional Jev layer needs an OpenRouter key and sends the text you select to OpenRouter, so avoid returning private page content or signed URLs unless you intend that.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.AetherAI3/agent-browser
Self-hosted Chrome for AI agents, with a live noVNC view a human can take over.
v0.2.2As shown on registry.modelcontextprotocol.io when we last read it