← Back to directory
H

Hyperbrowser MCP Server

Official
Scrape, crawl, and automate the web with Hyperbrowser's cloud browser and agent tools
GitHub source repository ↗
★ 790 Stars Category · Browser Popular Source revision 7492e83cf182
52FMRS · D
Reliability
7/20
Security and permissions
9/20
Maintenance
11/20
Documentation
12/20
Setup experience
13/20

The README is clear and provides concrete config examples for Cursor, Windsurf, and Claude Desktop plus a Smithery one-click install, with an explicit tool list; it does not include a machine-readable manifest or further permission details beyond the API key requirement.

Read the FMRS scoring method →

Hyperbrowser MCP Server is the official Model Context Protocol server for Hyperbrowser, giving MCP-compatible clients tools to scrape webpages, extract structured data, crawl linked pages, and drive general-purpose browser agents such as OpenAI's CUA, Anthropic's Claude Computer Use, and Browser Use. It requires a Hyperbrowser API key and runs as a stdio process launched via npx or Node.

Tools

scrape_webpage
Extract formatted content (markdown, screenshot, etc.) from any webpage
crawl_webpages
Navigate through multiple linked pages and extract LLM-friendly formatted content
extract_structured_data
Convert messy HTML into structured JSON
search_with_bing
Query the web and get results with Bing search
browser_use_agent
Fast, lightweight browser automation with the Browser Use agent
openai_computer_use_agent
General-purpose automation using OpenAI's CUA model
claude_computer_use_agent
Complex browser tasks using Claude computer use
create_profile
Creates a new persistent Hyperbrowser profile
delete_profile
Deletes an existing persistent Hyperbrowser profile
list_profiles
Lists existing persistent Hyperbrowser profiles

Setup

  1. Obtain a Hyperbrowser API key. 2. Run npx hyperbrowser-mcp <YOUR-HYPERBROWSER-API-KEY> directly, or add an mcpServers entry with HYPERBROWSER_API_KEY set to your key in Cursor's ~/.cursor/mcp.json, Windsurf's model_config.json, or Claude Desktop's config. 3. For development, clone the repo, run npm install, npm run build, then node dist/server.js. 4. Alternatively install for Claude Desktop via Smithery with npx -y @smithery/cli install @hyperbrowserai/mcp --client claude.
claude_desktop_config.json
{"mcpServers":{"hyperbrowser":{"command":"npx","args":["-y","hyperbrowser-mcp"],"env":{"HYPERBROWSER_API_KEY":"YOUR-API-KEY"}}}}

Fit and risk

Best for

  • Developers who want to scrape or crawl webpages directly from an MCP client
  • Automation pipelines that need messy HTML converted to structured JSON
  • Users who want browser agents (CUA/Claude Computer Use/Browser Use) to perform web tasks

Not for

  • Users who don't want to depend on a third-party cloud browser service or obtain an API key
  • Fully offline or air-gapped environments
  • Cost-sensitive projects unable to cover Hyperbrowser API usage fees

Required permissions

  • Requires a valid HYPERBROWSER_API_KEY to call the Hyperbrowser cloud service
  • The server makes outbound network requests and browser actions against external webpages on the user's behalf
  • Browser agent tools may require additional OpenAI or Anthropic credentials to drive CUA/Claude Computer Use

Risks and side effects

  • A misconfigured or leaked API key could be misused, incurring unexpected charges
  • Browser agents can click and submit forms on live pages, risking unintended actions or exposure to unexpected content
  • Scraping/crawling activity may violate target sites' terms of service or trigger anti-bot defenses

Troubleshooting

  1. Verify HYPERBROWSER_API_KEY is set correctly as an environment variable
  2. Check that npx can reach the network to download the hyperbrowser-mcp package
  3. For local development, confirm npm install and npm run build completed before running node dist/server.js
  4. Confirm the client's (Cursor/Windsurf/Claude Desktop) mcp config file path and JSON syntax are correct

Use cases

Scrape a webpage and convert it to markdown for LLM analysis
Crawl a multi-page site and extract content across linked pages
Convert unstructured webpage HTML into structured JSON
Pull live web results via Bing search
Use browser agents to fill forms, click through flows, and automate tasks

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support