bryg-mcp
v1.0.0
Published
BRYG — MCP server that gives your AI assistant hands on a real Chromium browser: navigate, click, type, read pages, OCR, QR, and network capture. Commercial software; a license key is required (14-day free trial).
Downloads
160
Maintainers
Readme
BRYG
Your AI assistant's hands on the browser
An MCP server that lets AI assistants drive a real Chromium browser — navigate, click, type, read pages, run OCR, decode QR codes, and record network traffic. Like a human operator, on your machine.
🌐 Website · 📖 Docs · 🔒 Security · 🔑 Privacy
US$3 per device / month · 14-day free trial · macOS (Apple Silicon) & Windows · works with Google Chrome
Quick start
Add BRYG to your MCP client:
{
"mcpServers": {
"bryg": {
"command": "npx",
"args": ["-y", "bryg-mcp"]
}
}
}Claude Code, in one line:
claude mcp add bryg -- npx -y bryg-mcpThen activate your license key:
npx bryg-mcp activate <your-license-key>No key yet? Start your 14-day free trial → — the key is emailed to you.
Until a key is activated, BRYG still starts and connects, but its tools stay inactive and answer with an activation reminder instead of doing work. Activate at any time; BRYG picks the key up within seconds, no restart needed.
What this package does
bryg-mcp is the official launcher. It carries no binary of its own: on first
run it resolves the current release, downloads the BRYG engine for your platform
(~70 MB, one time) into ~/.bryg/bin, verifies its SHA-256 checksum, and
hands stdio over to it. Later runs start straight from the installed engine, so
new BRYG releases arrive without you reinstalling this package.
Prefer a plain install without Node? Use the one-line installer instead:
# macOS
curl -fsSL https://bryg.pages.dev/install.sh | sh
# Windows (PowerShell)
irm https://bryg.pages.dev/install.ps1 | iexBoth paths share the same engine, the same ~/.bryg home, and the same license.
Why BRYG
- Sees pages like structure — accessibility-tree snapshots with stable element refs (
[ref=N]); compact and reliable for an AI to act on, with coordinate fallback. - OCR & QR built in — reads text from canvas, images, and games (multi-strategy OCR, any tesseract language) and decodes QR codes on the page.
- Network capture — record everything, keyword-filtered, or failures-only. Sensitive headers and password/token-like fields are masked by default.
- Credentials stay local —
browser_login_filltypes your credentials into the page without them ever entering the AI conversation. - Headful by design — a dedicated browser instance you can watch and take over at any time.
- Zero telemetry — everything runs on your machine; the only network calls are license validation and an anonymous update check.
Tools (43)
Perception — browser_snapshot · browser_read · browser_screenshot · browser_ocr · browser_qr · browser_page_info
Action — navigate · click · click by text · type · fill · replace · scroll · press keys · hover · drag · upload · select · clipboard, and more
Observation — network_start · network_stop · network_status
Targeting — xpath_by_text · xpath_at · xpath_for_ref
See the full tool reference.
CLI
Every argument is forwarded to the engine, so the whole CLI is available through npx:
| Command | Description |
|---|---|
| npx bryg-mcp | Start the MCP server (stdio) — this is what your MCP client runs |
| npx bryg-mcp activate <key> | Activate your license on this machine |
| npx bryg-mcp deactivate | Release this machine's license seat |
| npx bryg-mcp license | Show local license status |
| npx bryg-mcp setup | Guided setup: OCR, PATH, MCP client registration |
| npx bryg-mcp browser launch [url] \| stop | Manage the dedicated automation browser |
| npx bryg-mcp uninstall | Deactivate the seat, unregister, and remove ~/.bryg |
Requirements
- Node.js 18+ (for this launcher only — the engine ships its own runtime)
- macOS on Apple Silicon, or Windows x64
- Google Chrome (or another Chromium-based browser) installed
- Optional:
tesseractfor OCR —npx bryg-mcp setupinstalls it for you
Need an Intel Mac or Linux build? It is available as custom work — email [email protected].
Pricing
US$3 per device / month, with a 14-day free trial. One license key activates one device; add or remove devices at any time in the customer portal (billing, invoices, and cancellation live there too). See bryg.pages.dev for details.
Support
- 📖 Documentation — installation, CLI, configuration, all 43 tools, licensing FAQ, changelog
- 🐛 Issues
License
BRYG is commercial software provided under its End User License Agreement. The BRYG engine is not open source.
