webmcp-bridge

webmcp-bridge connects local MCP clients to website tools in the browser.

It is native-first:

• if a site exposes browser WebMCP, the bridge calls it directly
• if a site does not, the bridge falls back to a thin site adapter

Start Here

• Getting Started
• CLI And Control Plane
• Bridge Session Model
• Architecture
• Adapters
• Skills
• Release And Publishing

What Is In The Repo

• @webmcp-bridge/local-mcp: one-site stdio MCP server
• @webmcp-bridge/playwright: page gateway and browser lifecycle layer
• @webmcp-bridge/adapter-x: X fallback adapter
• @webmcp-bridge/adapter-google: Google and Gemini fallback adapter
• @webmcp-bridge/core: shared shim and runtime contracts
• examples/board: native WebMCP example app

Reader Paths

I want to connect one site quickly

Go to Getting Started.

I only see bridge.* tools and do not know what to do

Go to Bridge Session Model. That page explains bootstrap, attach, presentationMode, and bridge-only recovery.

I want to understand the architecture

Go to Architecture.

I want to operate X or Gemini

Go to Adapters.

I want to install agent skills

Go to Skills.

I want to publish a new release

Go to Release And Publishing.