anybridge MCP server
Commit Sep 3, 2026Converts any website into a set of MCP tools, allowing AI agents to interact with web pages, fill forms, and read content via a real browser.
Also known as JustVugg/anybridge
- Stars
- 28
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Sep 3, 2026
- License
- MIT
What is anybridge MCP?
anybridge converts any website into a set of MCP tools, allowing AI agents to interact with web pages, fill forms, and read content via a real browser.
Summary generated from the project's README
About anybridge MCP server
Turning any website into a functional set of tools for AI agents is the primary purpose of anybridge. It enables clients like Claude Code or Codex to interact with web pages by opening them in a real browser to read content, fill out forms, and click buttons. This works for modern sites and older portals alike by generating a bridge from the live DOM or capturing existing WebMCP tools.
Users can launch the service via a terminal interface using uvx or integrate it directly into MCP clients by adding the serve command. The system provides forty universal tools including navigate, read_page, click_ref, and fill_ref, alongside site-specific tools like update_cart if they are available. It handles complex tasks like extracting structured data from PDFs by converting them into marked text.
Developers can also use anybridge as a Python library within frameworks like LangGraph to create agents that share a single browser session. The server prioritizes efficiency by using plain HTTP when possible, falling back to Chromium only when JavaScript is required. If a live site becomes unavailable, the system degrades to a durable cache or the Internet Archive to maintain availability.
What you can do with it
- 1Convert legacy sites into agent toolsYou can make old web portals accessible to modern AI agents by generating tools from the live DOM.
- 2Integrate web browsing into Python agentsDevelopers can use the library to provide LangChain tools to a React agent.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
ANYBRIDGE_SKIP_BROWSER_TESTS
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablejustvugg/anybridge is public and reachablegithub.com/justvugg/anybridge ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-03github.com/justvugg/anybridge ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- 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 GitHubanybridge
Any website, within reach of any agent.
anybridge turns a website into tools an AI agent can actually use. It opens the page in a real browser and re-exposes it over the Model Context Protocol, so Claude Code, Codex, or anything else that speaks MCP can read the page, fill its forms, click its buttons and read its PDFs — including sites built long before agents existed.
Run it, pick your agent, paste a URL into it. That is the whole flow.
Why it exists
WebMCP lets a website declare typed, callable tools for AI agents. It is real and already deployed — Shopify ships it on storefronts today — but only Gemini in Chrome can consume those tools. anybridge captures them and hands them to every other agent.
And when a site has no WebMCP at all, which is almost every site, anybridge generates the bridge itself from the live DOM. A 2013 SharePoint portal and a modern Shopify store come out the same way: as a list of tools.
What an agent gets
Two sources of tools, merged, with the site's own taking precedence:
The site's native WebMCP tools, namespaced so a page can never shadow a
built-in — search_catalog, update_cart, whatever the site registered.
Forty universal tools that work on any page. The ones that matter most:
navigate, read_page, smart_read |
open and read, with PDFs returned as page-marked text |
snapshot |
a compact semantic tree with stable refs (@e12) instead of raw HTML |
click_ref, fill_ref, select_ref, press_key |
act on those refs |
extract, screenshot, wait_for |
structured data, images, synchronisation |
save_site, save_profile, save_workflow |
remember a site, a login, a recorded flow |
open_repository |
clone a Git remote and hand back a local path |
Run it
One command, nothing installed. uv fetches anybridge and its Python for you, and anybridge downloads its browser on first run:
uvx --from git+https://github.com/JustVugg/anybridge anybridge
That opens the TUI: pick your agent, and anybridge launches it in a second terminal already wired to the bridge.
To keep it around, install it properly (Python 3.10 or newer):
git clone https://github.com/JustVugg/anybridge.git
cd anybridge
pip install -e .
On a bare Linux box sudo playwright install-deps chromium supplies Chromium's
system libraries. Not on PyPI yet.
Use it
Wire it into an MCP client:
claude mcp add anybridge -- anybridge serve
{
"mcpServers": {
"anybridge": { "command": "anybridge", "args": ["serve"] }
}
}
Or from the shell, with no agent at all:
anybridge list https://www.bauzaar.it/ # the site's WebMCP tools plus the built-ins
anybridge call https://en.wikipedia.org/wiki/Rome read_page
Or as a library, when you want tools your framework already understands:
from anybridge import BridgeSession
from langgraph.prebuilt import create_react_agent
async with BridgeSession("https://www.bauzaar.it/") as site:
agent = create_react_agent("anthropic:claude-sonnet-5", site.langchain_tools())
site.anthropic_tools(), site.openai_tools() and site.tool_specs() cover the
other frameworks. One browser backs the whole session, so calls share page state.
How it holds up
It picks the cheapest route that works. Plain HTTP first, then optional Lightpanda, and Chromium only when the page truly needs JavaScript or state.
It stays available. Every route is bounded by one shared deadline. If the live site fails, anybridge degrades to a durable cache and finally to the Internet Archive — and says so, instead of pretending an action succeeded.
PDFs are text, never screenshots. Chromium's PDF viewer exposes an empty
DOM, so anybridge extracts the document, marks every page, and lets an agent
ask for pages="12-15" of a long one.
Untrusted pages stay in their box. Remote sessions get their own browser, private-network targets are blocked including across redirects, saved profiles are encrypted and scoped to one origin, and recorded workflows never store the values that were typed into them.
Limits
Aggressive anti-bot walls can still refuse a headless browser. When that happens anybridge reports what the page actually served and continues read-only from another source — it never invents a completed purchase, login or form submission. Archived pages are historical and cannot be used for live actions.
Development
python -m pytest tests/ # 49 tests
ANYBRIDGE_SKIP_BROWSER_TESTS=1 python -m unittest discover -s tests # without a browser
License
MIT
anybridge MCP questions
How do I use anybridge with Claude Code?
You can wire it into an MCP client using the command: claude mcp add anybridge -- anybridge serve.
Can anybridge handle websites that don't have native WebMCP tools?
Yes, if a site has no WebMCP, anybridge generates its own bridge directly from the live DOM.
How does anybridge handle PDF files on a webpage?
It extracts the document text and marks every page, allowing agents to request specific page ranges.
What happens if a website has aggressive anti-bot protections?
Anybridge will report what the page actually served and switch to read-only mode from another source rather than inventing actions.