Skip to main content
Glama

browserbridge-mcp

PyPI version CI License: MIT Python 3.10+ MCP Compliant M8ven Score

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-N descriptors.

  • Clean Text Extraction: Strips <script>, <style>, <svg>, and markup noise into readable plain text.

  • SHA-256 Durable Action Receipts: Every navigate_page, click_element, and fill_form_field call records pre_state_hash and post_state_hash transitions in SQLite (~/.browserbridge/receipts.db, 0600) for audit verification via verify_action_trail.

  • Session Pool Reaper: Isolates concurrent session_id states and evicts idle sessions automatically after configurable TTL expiration.

Related MCP server: Charlotte

Quickstart

Run with uvx

uvx browserbridge-mcp

Claude 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 default

MCP Tools Reference

Tool

Parameters

Description

navigate_page

url, session_id

Fetch an HTTP(S) page into session state and issue a SHA-256 receipt

extract_clean_text

session_id

Extract plain readable text from the current session HTML

extract_accessibility_tree

session_id

Extract compact interactive AOM nodes (@node-1, buttons, links, inputs)

click_element

selector, session_id

Resolve selector/AOM target, record session click state, and issue a receipt

fill_form_field

selector, value, session_id

Populate session form field state and issue a receipt

get_page_status

session_id

Return current URL, title, HTTP status code, and truncated DOM hash

get_action_receipt

receipt_id

Fetch full stored receipt record by receipt_id

verify_action_trail

session_id

Verify contiguous post_state_hash == next.pre_state_hash chain across a session

get_pool_status

(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

GitHub

BrowserBridge MCP

Lightweight HTTP/DOM session automation with SHA-256 action receipts

GitHub

PgSafe MCP

Read-only PostgreSQL/SQLite query guard, PII masking, and dry-run mutations

GitHub

OmniBridge MCP

Multi-channel notification bus with SQLite retry queue

GitHub

SysFlow MCP

Linux systemd inspection, confined log tailing, and port auditing

GitHub

FastMCP Forge

Zero-dependency FastMCP framework, CLI scaffolder, and SSE middleware

GitHub

Support

If you find this project useful, you can support maintenance on Ko-fi.

License

MIT (c) 2026 Johann Schiffer

Available Tools

6 tools
click_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

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All names use snake_case verb_noun format (navigate_page, extract_clean_text, click_element, etc.). Consistent and predictable.

    Tool Count5/5

    Six tools is well-scoped for a focused headless browser bridge. Each tool covers a core operation without redundancy.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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
      -