BRYG

What BRYG does

BRYG exposes browser automation through MCP, allowing an AI client to control a dedicated Chromium browser running on the local machine. Its tools cover browser and window management, page navigation, accessibility inspection, reading, screenshots, mouse actions, keyboard input, form controls, file uploads, and page-side JavaScript evaluation.

The server is suited to interactive web workflows rather than API-only access. An agent can inspect a page, identify interactive elements from an accessibility-tree snapshot, act on stable references, and verify the resulting page state. Coordinate-based actions are also available when element references are not suitable.

BRYG includes OCR for text rendered in images, canvas elements, or games, plus QR-code decoding. Network observation can record browser traffic, apply keyword filters, or focus on failures. Captured sensitive headers and password- or token-like fields are masked by default.

How it works

BRYG runs as a plain stdio MCP server. The client starts the bryg executable, then sends tool calls over MCP. Browser actions are routed to the selected page, and a page opened in a new browser or window can be addressed by its page identifier.

The browser is designed to run headful so a person can watch and take over the session. On Linux without a display, it switches to headless operation. Separate isolated windows can maintain different cookies and login states, which allows multiple accounts to be used at once until the browser closes.

Credentials can be supplied through a credentials file or directly to the login-fill tool. BRYG fills detected username and password fields but does not submit the form; a separate click action is used for submission. This keeps secrets out of the assistant conversation.

Setup and configuration

Install with the macOS/Linux shell installer or the Windows PowerShell installer. The installer places the platform-specific binary under ~/.bryg/bin/ or %USERPROFILE%\\.bryg\\bin\\, verifies its SHA-256 checksum, and guides client registration, optional OCR installation, and license activation.

A direct MCP configuration can use the bryg-mcp npm launcher, which requires Node.js 18 or newer:

{
  "mcpServers": {
    "bryg": { "command": "npx", "args": ["-y", "bryg-mcp"] }
  }
}

The launcher downloads the matching engine on first use and stores it under ~/.bryg/bin/. Activation uses npx bryg-mcp activate <key>, or the installed CLI can run bryg activate <key>. A license key is required; the product offers a 14-day trial and paid per-device licensing.

The guided setup registers BRYG with Claude Code and Claude Desktop. Other MCP clients can start the binary directly as a stdio server. On Linux, Google Chrome is used; Chrome for Testing can be unpacked into ~/.bryg/chrome-linux64/ when a system installation is unavailable.

Tools and capabilities

• List, open, activate, and close browser tabs across Chrome and Edge.
• Create normal, new-window, or isolated browser sessions.
• Navigate, reload, and traverse browser history.
• Inspect URL, title, viewport, scroll position, accessibility structure, text, and links.
• Click by visible text, element reference, or coordinates; also double-click, right-click, hover, drag, and long-press.
• Type, replace, fill, focus, select options, upload files, scroll, and press key combinations.
• Capture screenshots, including full-page images, and optionally save them to disk.
• Run JavaScript in the page and return JSON results.
• Perform credential filling, OCR, QR decoding, and network capture.

Limitations and notes

BRYG is commercial software distributed under an End User License Agreement; its binary is not open source. The server runs locally, but it makes network calls for license validation and an anonymous update check. A dedicated browser session can be watched and controlled manually, while isolated login state lasts only until the browser closes. Linux operation requires Chrome or a compatible unpacked Chrome for Testing installation, and automatically uses headless mode when no display is available.