BrowserBridge MCP
BrowserBridge MCP provides lightweight HTTP/DOM session automation for MCP agents.
Navigate an HTTP(S) URL within a session.
Extract cleaned, readable text from the current page.
Extract a compact Accessibility Object Model tree of interactive elements.
Click elements by CSS selector or target ID.
Fill form inputs/textareas with values.
Inspect current session state, URL, title, HTTP status, and DOM hash.
Isolate workflows using
session_id(default:default).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BrowserBridge MCP navigate to news.ycombinator.com and extract the accessibility tree"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
browserbridge-mcp
BrowserBridge MCP is a lightweight HTTP/DOM session bridge, Accessibility Object Model (AOM) extractor, and SHA-256 action receipt ledger for Model Context Protocol (2024-11-05) agents.
Instead of launching heavy browser binaries for static or server-rendered web workflows, BrowserBridge fetches HTML over httpx, distills interactive elements into compact @node trees, tracks stateful form/click transitions per session, and records append-only SHA-256 DOM hash chains in SQLite.
Features
HTTP Navigation with Redirect SSRF Guard: Validates initial and redirect URLs against loopback, RFC1918 private networks, and cloud metadata (
169.254.169.254).Accessibility Object Model (AOM) Extraction: Condenses
<button>,<a href>, and<input>elements into compact@node-Ndescriptors.Clean Text Extraction: Strips
<script>,<style>,<svg>, and markup noise into readable plain text.SHA-256 Durable Action Receipts: Every
navigate_page,click_element, andfill_form_fieldcall recordspre_state_hashandpost_state_hashtransitions in SQLite (~/.browserbridge/receipts.db,0600) for audit verification viaverify_action_trail.Session Pool Reaper: Isolates concurrent
session_idstates and evicts idle sessions automatically after configurable TTL expiration.
Related MCP server: Charlotte
Quickstart
Run with uvx
uvx browserbridge-mcpClaude Desktop / Cursor Configuration
{
"mcpServers": {
"browserbridge-mcp": {
"command": "uvx",
"args": ["browserbridge-mcp"]
}
}
}CLI Inspection
# Inspect interactive AOM nodes of a public web page
browserbridge aom https://example.com
# Verify SHA-256 receipt continuity for a session
browserbridge verify-trail --session defaultMCP Tools Reference
Tool | Parameters | Description |
|
| Fetch an HTTP(S) page into session state and issue a SHA-256 receipt |
|
| Extract plain readable text from the current session HTML |
|
| Extract compact interactive AOM nodes ( |
|
| Resolve selector/AOM target, record session click state, and issue a receipt |
|
| Populate session form field state and issue a receipt |
|
| Return current URL, title, HTTP status code, and truncated DOM hash |
|
| Fetch full stored receipt record by |
|
| Verify contiguous |
| (none) | Inspect active session count, session IDs, and idle TTL configuration |
Genesis MCP Ecosystem
Module | Description | Repository |
CrawlEngine MCP | HTTP web extraction to clean Markdown, JSON-LD parsing, and proxy rotation | |
BrowserBridge MCP | Lightweight HTTP/DOM session automation with SHA-256 action receipts | |
PgSafe MCP | Read-only PostgreSQL/SQLite query guard, PII masking, and dry-run mutations | |
OmniBridge MCP | Multi-channel notification bus with SQLite retry queue | |
SysFlow MCP | Linux systemd inspection, confined log tailing, and port auditing | |
FastMCP Forge | Zero-dependency FastMCP framework, CLI scaffolder, and SSE middleware |
Support
If you find this project useful, you can support maintenance on Ko-fi.
License
MIT (c) 2026 Johann Schiffer
Available Tools
6 toolsclick_elementC
Click an interactive element by CSS selector or target ID.
Inputs: selector (required), session_id.
extract_accessibility_treeA
Extract interactive elements (buttons, links, inputs) as an Accessibility Object Model (AOM), reducing token cost by ~95%.
Inputs: session_id.
extract_clean_textB
Extract cleaned, semantic markdown text from current page, stripping scripts and clutter.
Inputs: session_id.
fill_form_fieldC
Enter text or value into a form input or textarea.
Inputs: value (required), selector (required), session_id.
get_page_statusA
Inspect active session state, current URL, page title, and HTTP response code.
Inputs: session_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action: navigation, two extraction modes with clearly different outputs (markdown vs AOM), clicking, status inspection, and form filling. The two extraction tools are differentiated by description, so an agent can choose correctly.
All names use snake_case verb_noun format (navigate_page, extract_clean_text, click_element, etc.). Consistent and predictable.
Six tools is well-scoped for a focused headless browser bridge. Each tool covers a core operation without redundancy.
Core navigation, extraction, and basic interaction are covered, but common browser automation operations like scrolling, waiting for elements, taking screenshots, executing JavaScript, or handling multiple tabs are absent. These gaps may force workarounds for complex workflows.
Maintenance
Related MCP Connectors
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Hosted browser for AI agents: screenshots, post-JS DOM, console, WCAG. No install, no API key.
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to browse and interact with web pages through a persistent headless Chromium session, serving compact structured orientations, targeted element queries, and full detail only when explicitly requested. It supports navigation, observation, form filling, monitoring, and session management while cutting token overhead by up to ~140x versus raw accessibility-tree dumps.4 npm-
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to browse and interact with web pages through compact, typed structural representations — landmarks, headings, interactive elements, and forms — served in three controllable detail levels instead of full accessibility-tree dumps. Agents can navigate, query for specific elements, fill forms, manage tabs and cookies, capture screenshots, and run audits while paying a fraction of the token cost.4 npm-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to browse, navigate, and interact with web pages through structured, token-efficient page representations — returning compact orientations and targeted element queries instead of full accessibility-tree dumps.4 npm-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to browse and interact with web pages through compact, structured representations — page summaries, targeted element queries, and full detail on demand — instead of paying for a full accessibility-tree dump on every call. This cuts the token cost of reading content-heavy pages by up to ~140x while still supporting navigation, forms, clicks, screenshots, and session management.4 npm-