mcpField
H
Hyperbrowser MCP Server

Hyperbrowser MCP Server

Local
github.com/hyperbrowseraiBrowser Automation792Updated 75w ago
Repository

About Hyperbrowser MCP Server

Hyperbrowser MCP Server is an MCP server from Hyperbrowser for scraping pages, extracting structured data and crawling sites. It also exposes general-purpose browser agents, aimed at developers and AI applications that need web content.

Key features

  1. 01Scrape pages into markdown or screenshots
  2. 02Crawl linked pages into LLM-friendly content
  3. 03Convert messy HTML into structured JSON
  4. 04Search the web with Bing
  5. 05Run browser agents based on Browser Use, OpenAI CUA and Claude computer use
  6. 06Create, list and delete persistent browser profiles

Use cases

  1. 01Extract page content for an agent to read
  2. 02Collect data from several linked pages
  3. 03Turn web page information into JSON

MCP support

This is an MCP server that exposes scraping, crawling, search and browser agent tools to MCP clients. It also provides Hyperbrowser documentation through MCP resources.

#hyperbrowser#web-scraping#data-extraction

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hyperbrowserai": {
      "command": "npx",
      "args": [
        "-y",
        "hyperbrowser-mcp"
      ],
      "env": {
        "HYPERBROWSER_API_KEY": "<HYPERBROWSER_API_KEY>"
      }
    }
  }
}
Run commandnpx -y hyperbrowser-mcp
Environment variables to set
HYPERBROWSER_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmhyperbrowser-mcp

Tools

10

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
urlstringYesThe URL of the webpage to scrape
sessionOptionsobjectNoOptions for the browser session. Avoid setting these if not mentioned explicitly
sessionOptions.useProxybooleanNoWhether to use a proxy. Recommended false.
sessionOptions.useStealthbooleanNoWhether to use stealth mode. Recommended false.
sessionOptions.solveCaptchasbooleanNoWhether to solve captchas. Recommended false.
sessionOptions.acceptCookiesbooleanNoWhether to automatically close the accept cookies popup. Recommended false.
sessionOptions.profileobjectNoOptions for using a persistent Hyperbrowser profile
sessionOptions.profile.idstringNoID of the persistent profile to use for the session
sessionOptions.profile.persistChangesbooleanNoWhether changes made during the session should be saved to the profile. Recommended true.
outputFormatarrayYesThe format of the output

Details

From the project README

Hyperbrowser MCP Server

smithery badge

Frame 5

This is Hyperbrowser's Model Context Protocol (MCP) Server. It provides various tools to scrape, extract structured data, and crawl webpages. It also provides easy access to general purpose browser agents like OpenAI's CUA, Anthropic's Claude Computer Use, and Browser Use.

More information about the Hyperbrowser can be found here. The hyperbrowser API supports a superset of features present in the mcp server.

More information about the Model Context Protocol can be found here.

Table of Contents

Installation

Manual Installation

To install the server, run:

npx hyperbrowser-mcp <YOUR-HYPERBROWSER-API-KEY>

Running on Cursor

Add to ~/.cursor/mcp.json like this:

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": ["-y", "hyperbrowser-mcp"],
      "env": {
        "HYPERBROWSER_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Running on Windsurf

Add to your ./codeium/windsurf/model_config.json like this:

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": ["-y", "hyperbrowser-mcp"],
      "env": {
        "HYPERBROWSER_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}
Development

For development purposes, you can run the server directly from the source code.

  1. Clone the repository:

    git clone [email protected]:hyperbrowserai/mcp.git hyperbrowser-mcp
cd hyperbrowser-mcp

  2. Install dependencies:

    npm install # or yarn install
npm run build

  3. Run the server:

    node dist/server.js

Claude Desktop app

This is an example config for the Hyperbrowser MCP server for the Claude Desktop client.

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": ["--yes", "hyperbrowser-mcp"],
      "env": {
        "HYPERBROWSER_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

  • scrape_webpage - Extract formatted (markdown, screenshot etc) content 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.
Installing via Smithery

To install Hyperbrowser MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @hyperbrowserai/mcp --client claude

Resources

The server provides the documentation about hyperbrowser through the resources methods. Any client which can do discovery over resources has access to it.

License

This project is licensed under the MIT License.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.