Lets AI assistants drive a real Chromium browser to navigate, click, type, read pages, perform OCR, and capture network traffic.
Also known as flexiblepackage/bryg, bryg-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 4, 2026
- License
- —
What is BRYG MCP?
BRYG lets AI assistants drive a real Chromium browser to navigate, click, type, read pages, perform OCR, and capture network traffic.
Summary generated from the project's README
About BRYG MCP server
Giving AI assistants the ability to interact with a real Chromium browser is what BRYG enables for developers using clients like Claude Desktop, Claude Code, Cursor, or Hermes. By running as a local stdio server on macOS, Windows, or Linux, it allows an AI to navigate websites, click elements, type text, and perform complex tasks through 43 specialized tools. It functions like a human operator on your machine, providing perception through accessibility-tree snapshots and observation through network traffic recording.
Users must acquire a license key to activate the service, which costs $100 per device per month after a 14-day free trial. The setup process involves running a platform-specific installer or using npx to download the engine. While it can run headless on Linux servers, it is designed to be headful so you can watch the browser instance in real time. Security is prioritized by masking sensitive network headers and keeping credentials local to your machine.
What you can do with it
- 1Automated web testing and QAAn AI can perform daily quality assurance tasks by navigating pages and interacting with elements like a human.
- 2Extracting text from visual elementsYou can instruct an AI to read text from images, canvas elements, or games using built-in optical character recognition.
- 3Monitoring web network activityDevelopers can have an AI assistant record and filter network traffic to identify failures or specific keyword matches.
- 4Interacting with complex web structuresAn AI can precisely target web elements using stable accessibility-tree references instead of just coordinates.
Written from the project's README. Every use case is checked against a quote from it.
How to install BRYG MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BRYG MCP in Claude Code
$ claude mcp add bryg -- npx -y bryg-mcpInstall BRYG MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bryg": {
"command": "npx",
"args": [
"-y",
"bryg-mcp"
]
}
}
}Install BRYG MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bryg": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bryg-mcp"
]
}
}
}Install BRYG MCP in VS Code CLI
$ code --add-mcp '{"name":"bryg","type":"stdio","command":"npx","args":["-y","bryg-mcp"]}'Install BRYG MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"bryg": {
"command": "npx",
"args": [
"-y",
"bryg-mcp"
]
}
}
}Install BRYG MCP in Codex
$ codex mcp add bryg -- npx -y bryg-mcpInstall BRYG MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.bryg] command = "npx" args = ["-y", "bryg-mcp"]
Install BRYG MCP in Gemini CLI
$ gemini mcp add -s user bryg npx -- -y bryg-mcpInstall BRYG MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"bryg": {
"command": "npx",
"args": [
"-y",
"bryg-mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableflexiblepackage/bryg is public and reachablegithub.com/flexiblepackage/bryg ↗Pass
- Package names this repository as its sourcebryg-mcp names flexiblepackage/bryg as sourcenpmjs.com/package/bryg-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-04github.com/flexiblepackage/bryg ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from bryg-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBRYG
Your AI assistant's hands on the browser
BRYG is an MCP server that lets AI assistants drive real Chromium-based browsers — navigate, click, type, read pages, run OCR, and record network traffic. Like a human operator, on your machine.
🌐 Website · 📖 Docs · 🔒 Security · 🔑 Privacy
$100 per device/month · 14-day free trial · macOS (Apple Silicon), Windows (x64) & Linux (x64) · Works with Google Chrome
What is BRYG?
BRYG implements the Model Context Protocol (MCP) as a plain stdio server, so any compatible client — Claude Code, Claude Desktop, Hermes, Cursor, and others — can control a Chromium browser on your machine. It gives your AI assistant 43 tools covering perception, action, and observation, designed from daily QA work rather than demos.
Note: This repository hosts BRYG's public documentation and issue tracker. The product itself is a single self-contained binary, distributed via the installer below and verified by SHA-256 checksum on download.
Get started
BRYG is a licensed product — you need a key to activate it. It takes about a minute:
- Get a license key — start your 14-day free trial at bryg.pages.dev and pick how many devices you need ($100 per device/month). Your license key is emailed to you (billing, cancellation, and refunds are handled in the customer portal linked in that email).
- Install — run the one-line installer for your OS (below).
- Activate — the guided setup asks for your key during install, or run
bryg activate <key>anytime.
Licensing more than one device
Each device gets its own license key, and each key activates one machine. Pick the number of devices at checkout — 3 devices is $300/month. Your own key is issued immediately; for every additional device you enter an email address, and the invitation link sent there issues that device its own key. All of your keys are listed together in the customer portal, and you can add or remove devices at any time with prorated billing.
Install
macOS / Linux
curl -fsSL https://bryg.pages.dev/install.sh | sh
Windows (PowerShell)
irm https://bryg.pages.dev/install.ps1 | iex
The installer downloads the right binary for your OS/architecture to ~/.bryg/bin/ (%USERPROFILE%\.bryg\bin\ on Windows), verifies its SHA-256 checksum, then runs a guided setup that registers BRYG with your MCP client(s), optionally installs OCR support, and activates your license key.
On Linux, BRYG drives Google Chrome (no Edge) and runs it headless automatically when there is no display — servers, SSH sessions. No root to install Chrome? Unpack Chrome for Testing into ~/.bryg/chrome-linux64/. See the Linux notes.
npm / npx — if you'd rather configure your MCP client directly (needs Node.js 18+):
{
"mcpServers": {
"bryg": { "command": "npx", "args": ["-y", "bryg-mcp"] }
}
}
bryg-mcp is a launcher: on first run it downloads the BRYG engine for your platform into ~/.bryg/bin, verifies its checksum, and starts it — same engine, same license, same ~/.bryg as the installers above. Activate with npx bryg-mcp activate <key>; every other command works the same way.
Why BRYG
- Sees pages like structure — accessibility-tree snapshots with stable element refs (
[ref=N]); compact and reliable for 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 — secrets never enter AI conversations.
- Headful by design — a dedicated browser instance you can watch and take over at any time (on display-less Linux it runs headless automatically).
- Zero telemetry — runs entirely 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
Action — navigate · click · type · fill · scroll · press keys · drag · upload · select, and more
Observation — network_start · network_stop · network_status
See the full tool reference.
CLI
| Command | Description |
|---|---|
bryg |
Start the MCP server (stdio) — this is what your MCP client runs |
bryg setup [--yes] [--no-ocr] [--no-path] |
Guided setup (re-runnable) |
bryg activate <key> |
Activate your license on this machine |
bryg deactivate |
Release this machine's license seat |
bryg update [--check] |
Update BRYG (verified by checksum) |
bryg browser launch [url] | stop |
Manage the dedicated automation browser |
bryg uninstall [--yes] |
Deactivate seat, unregister, and remove ~/.bryg |
Registering with an MCP client
bryg setup registers BRYG with Claude Code and Claude Desktop for you. For any other client, point it at the binary as a stdio server. Hermes, for example, takes a few lines in ~/.hermes/config.yaml followed by /reload-mcp:
mcp_servers:
bryg:
command: "${userHome}/.bryg/bin/bryg"
args: []
enabled: true
Documentation
Full documentation — installation, CLI, configuration, all 43 tools, licensing FAQ, and changelog — lives at bryg.pages.dev/docs.
Support
- 🐛 Found a bug or have a feature request? Open an issue.
- 💬 Questions? See the FAQ or reach out via the site.
License
BRYG is commercial software provided under its End User License Agreement. This repository's documentation content is © BRYG. The BRYG binary is not open source.
BRYG MCP questions
How do I add BRYG MCP to Claude Code?
Run claude mcp add bryg -- npx -y bryg-mcp in your terminal. Add --scope user to make it available in every project.
How do I add BRYG MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What operating systems does BRYG support?
BRYG is compatible with macOS (Apple Silicon), Windows (x64), and Linux (x64).
How much does BRYG cost?
The service costs $100 per device per month, and a 14-day free trial is available.
Does BRYG send my credentials to the AI?
No, credentials stay local and secrets never enter AI conversations.