hyperbrowserai/mcp

How hyperbrowserai/mcp works

Hyperbrowser MCP Server exposes webpage collection, structured extraction, search, browser agents, persistent profiles, and documentation resources to MCP clients over stdio or SSE. Clients invoke registered tools; handlers call the Hyperbrowser SDK and return results. SSE can validate bearer API keys against Hyperbrowser, while resource discovery and reads serve bundled documentation. The graph preserves the README’s major tool families; dynamic resource modules are present in the tree but their runtime wiring was not shown, so no connections to them are asserted.

Main entry points: setup_server.ts Tool Registry · sse.ts SSE Transport · stdio.ts Stdio Transport · server.ts Server Startup

Components 21

MCP Entry

Server Startup src/server.ts
Stdio Transport src/transports/stdio.ts
SSE Transport src/transports/sse.ts
Tool Registry src/transports/setup_server.ts
Tool Schemas src/tools/tool-types.ts

Web Data Tools

Web Scraping src/tools/scrape-webpage.ts
Web Crawling src/tools/crawl-webpages.ts
Structured Extraction src/tools/extract-structured.ts
Bing Search src/tools/bing-search.ts

Browser Agents

Browser Use Agent src/tools/browser-use.ts
OpenAI CUA src/tools/oai-cua.ts
Claude Computer Use src/tools/claude-computer-use.ts

Profiles

Create Profile src/tools/create-profile.ts
Delete Profile src/tools/delete-profile.ts
List Profiles src/tools/list-profiles.ts

Documentation Resources

Resource Handlers src/resources/static/get_resources.ts
Bundled Documentation src/resources/static/data/summarized.json
Dynamic Resources src/resources/dynamic
LLMs Text Parser src/resources/dynamic/llms-txt-parser.ts

Other components

MCP Client
Hyperbrowser API

Connections 28

MCP Client → Stdio Transport: connects via stdio src/transports/stdio.ts
MCP Client → SSE Transport: connects via SSE src/transports/sse.ts
Server Startup → Stdio Transport: starts by default src/server.ts
Server Startup → SSE Transport: starts on flag src/server.ts
Stdio Transport → Tool Registry: sets up tools src/transports/stdio.ts
SSE Transport → Tool Registry: sets up tools src/transports/sse.ts
Tool Registry → Tool Schemas: uses schemas src/transports/setup_server.ts
Tool Registry → Web Scraping: registers src/transports/setup_server.ts
Tool Registry → Web Crawling: registers src/transports/setup_server.ts
Tool Registry → Structured Extraction: registers src/transports/setup_server.ts
Tool Registry → Bing Search: registers src/transports/setup_server.ts
Tool Registry → Browser Use Agent: registers src/transports/setup_server.ts
Tool Registry → OpenAI CUA: registers src/transports/setup_server.ts
Tool Registry → Claude Computer Use: registers src/transports/setup_server.ts
Tool Registry → Create Profile: registers src/transports/setup_server.ts
Tool Registry → Delete Profile: registers src/transports/setup_server.ts
Tool Registry → List Profiles: registers src/transports/setup_server.ts
Tool Registry → Resource Handlers: routes resource requests src/transports/setup_server.ts
Resource Handlers → Bundled Documentation: reads documentation src/resources/static/get_resources.ts
Web Scraping → Hyperbrowser API: calls SDK src/tools/scrape-webpage.ts
Web Crawling → Hyperbrowser API: calls SDK src/tools/crawl-webpages.ts
Structured Extraction → Hyperbrowser API: calls SDK src/tools/extract-structured.ts
Bing Search → Hyperbrowser API: extracts results src/tools/bing-search.ts
Browser Use Agent → Hyperbrowser API: runs agent src/tools/browser-use.ts
OpenAI CUA → Hyperbrowser API: runs agent src/tools/oai-cua.ts
Claude Computer Use → Hyperbrowser API: runs agent src/tools/claude-computer-use.ts
SSE Transport → Hyperbrowser API: validates API key src/transports/sse.ts
Dynamic Resources → LLMs Text Parser: contains parser src/resources/dynamic/parse-resources.ts

Drawn by GitDiagram on November 15, 2026 from the repository's file tree, README and source files. Read as Markdown ·