Metadata-Version: 2.5
Name: browserr-mcp
Version: 0.7.1
Summary: MCP server for Browserr, the Servo-based agent browser. One command; the platform engine binary is downloaded and digest-verified on first run.
Project-URL: Homepage, https://browserr.dev/
Project-URL: Repository, https://github.com/Omodaka9375/browserr
Project-URL: Changelog, https://github.com/Omodaka9375/browserr/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Omodaka9375/browserr/issues
Author: Omodaka9375
License-Expression: Apache-2.0
Keywords: agents,ai,browser,browser-automation,headless,mcp,model-context-protocol,servo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Rust
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# browserr-mcp

[MCP](https://modelcontextprotocol.io) server for
[Browserr](https://browserr.dev) — the Servo-based browser engine built
for AI agents. One command; the platform engine binary is downloaded and
sha256-verified on first run.

```json
{
  "mcpServers": {
    "browserr": {
      "command": "uvx",
      "args": ["browserr-mcp"]
    }
  }
}
```

or, installed directly:

```json
{
  "mcpServers": {
    "browserr": { "command": "browserr-mcp" }
  }
}
```

## What you get

42 tools covering navigation, token-cheap page reads, structured page
inventories with stable element refs (`e7`), type-aware form filling,
annotated screenshots, fail-closed request interception, HTTP-auth and
file-picker events, evidence capture, and human handoff (pause the
page, let a person handle the CAPTCHA, resume).

The engine is a single Rust binary (Servo 0.8): CPU rendering by
default, EasyList adblock built in, no Chromium, no CDP, no driver
downloads. It runs on Windows, Linux (x64/ARM64) and macOS.

Browserr fails closed by design: uncertain requests are blocked, not
guessed; credentials are never logged; every run leaves timestamped
evidence.

## Environment variables

| Variable | Default | Purpose |
| --- | --- | --- |
| `BROWSERR_VERSION` | latest release | pin a release tag, e.g. `v0.7.1` |
| `BROWSERR_HOME` | `~/.browserr/versions/<version>` | install dir; an existing unpack with the engine binary skips the download |

## First run

The bootstrap queries the official GitHub release API, downloads the
platform asset, verifies it against the sha256 digest GitHub reports
for that asset, and unpacks it under `~/.browserr/versions/<version>`.
A missing digest is a hard stop — the digest is the corruption guard;
TLS only covers the transport.

Prefer to install ahead of time?

```sh
uvx browserr-install
```

## Links

- Browserr: https://browserr.dev/
- Source: https://github.com/Omodaka9375/browserr
- Changelog: https://github.com/Omodaka9375/browserr/blob/main/CHANGELOG.md

Apache-2.0. Engine and Python tooling are stdlib-only; this bootstrap
adds no third-party Python dependencies.
