Hyperbrowser logo

Hyperbrowser

Organization
hyperbrowserai

A MCP server implementation for hyperbrowser

Publisherhyperbrowserai
Repositorymcp
LanguageTypeScript
Forks
74
Stars
791
Available tools
10
Transport typestdio
Categories
LicenseMIT
Links
  • Connect tools to AI workflows

    Hyperbrowser exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 10 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    791 stars and 74 forks from the linked repository.

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:

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

Running on Cursor

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

json
{
  "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:

json
{
  "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:

    sh
    git clone git@github.com:hyperbrowserai/mcp.git hyperbrowser-mcp
    cd hyperbrowser-mcp
  2. Install dependencies:

    sh
    npm install # or yarn install
    npm run build
  3. Run the server:

    sh
    node dist/server.js

Claude Desktop app

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

json
{
  "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:

bash
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.

Installation

TypingMind
Prerequisites:

Node.js 18+

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

Available Tools

  • scrape_webpage

    Scrape a webpage and extract its content in various formats. This tool allows fetching content from a single URL with configurable browser behavior options. Use this for extracting text content, HTML structure, collecting links, or capturing screenshots of webpages.

  • crawl_webpages

    Crawl a website starting from a URL and explore linked pages. This tool allows systematic collection of content from multiple pages within a domain. Use this for larger data collection tasks, content indexing, or site mapping.

  • extract_structured_data

    Extract structured data from a webpage. This tool allows you to extract structured data from a webpage using a schema.

  • browser_use_agent

    This tool employs an open-source browser automation agent optimized specifically for fast, efficient, and cost-effective browser tasks using a cloud browser. It requires explicit, detailed instructions to perform highly specific interactions quickly.

    Optimal for tasks requiring:

    • Precise, explicitly defined interactions and actions
    • Speed and efficiency with clear, unambiguous instructions
    • Cost-effective automation at scale with straightforward workflows

    Best suited use cases include:

    • Explicitly defined registration and login processes
    • Clearly guided navigation through web apps
    • Structured, step-by-step web scraping with detailed guidance
    • Extracting data via explicitly specified browser interactions

    You must provide extremely detailed step-by-step instructions, including exact elements, actions, and explicit context. Clearly define the desired outcome for optimal results. Returns the completed result or an error message if issues arise.

    Note: This agent trades off flexib

  • openai_computer_use_agent

    This tool utilizes OpenAI's model to autonomously execute general-purpose browser-based tasks with balanced performance and reliability using a cloud browser. It handles complex interactions effectively with practical reasoning and clear execution.

    Optimal for tasks requiring:

    • Reliable, general-purpose browser automation
    • Clear, structured interactions with moderate complexity
    • Efficient handling of common web tasks and workflows

    Best suited use cases include:

    • Standard multi-step registration or form submissions
    • Navigating typical web applications requiring multiple interactions
    • Conducting structured web research tasks
    • Extracting data through interactive web processes

    Provide a clear step-by-step description, necessary context, and expected outcomes. Returns the completed result or an error message if issues arise.

  • claude_computer_use_agent

    This tool leverages Anthropic's Claude model to autonomously execute complex browser tasks with sophisticated reasoning capabilities using a cloud browser. It specializes in handling intricate, nuanced, or highly context-sensitive web interactions.

    Optimal for tasks requiring:

    • Complex reasoning over multiple web pages
    • Nuanced interpretation and flexible decision-making
    • Human-like interaction with detailed context awareness

    Best suited use cases include:

    • Multi-step processes requiring reasoning (e.g., detailed registrations or onboarding)
    • Interacting intelligently with advanced web apps
    • Conducting in-depth research with complex conditions
    • Extracting information from dynamic or interactive websites

    Provide detailed task instructions, relevant context, and clearly specify the desired outcome for best results. Returns the completed result or an error message if issues arise.

  • search_with_bing

    Search the web using Bing. This tool allows you to search the web using bing.com

  • create_profile

    Creates a new persistent Hyperbrowser profile.

  • delete_profile

    Deletes an existing persistent Hyperbrowser profile.

  • list_profiles

    Lists existing persistent Hyperbrowser profiles, with optional pagination.

Use Hyperbrowser MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once Hyperbrowser is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add Hyperbrowser as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the Hyperbrowser MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": [
        "-y",
        "hyperbrowser-mcp"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the Hyperbrowser MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the Hyperbrowser MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use Hyperbrowser to help me with this task?
Hyperbrowser
Sure. I read it.
Here is what I found using Hyperbrowser.

Frequently asked questions

What is the Hyperbrowser MCP server used for?

Hyperbrowser is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use Hyperbrowser MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use Hyperbrowser with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use Hyperbrowser MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With Hyperbrowser connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect Hyperbrowser MCP to TypingMind?

Hyperbrowser runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does Hyperbrowser MCP provide in TypingMind?

Hyperbrowser exposes 10 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use Hyperbrowser MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If Hyperbrowser requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Welcome to Hyperbrowser | Hyperbrowser

Hyperbrowser documentation provides an introduction to web scraping and automation using the Hyperbrowser tool.

What are Headless browsers ? | Hyperbrowser

The page explains headless browsers and their role in Hyperbrowser for web scraping and automation tasks.

Scraping | Hyperbrowser

The "Scraping" page in Hyperbrowser details how to extract data from websites using the tool's functionalities.

Crawling | Hyperbrowser

The "Crawling" page of Hyperbrowser covers the tool's web scraping capabilities and how to implement them.

Quickstart | Hyperbrowser

Quickstart guide for Hyperbrowser provides initial setup and functionality instructions for effective web scraping and automation.

Puppeteer | Hyperbrowser

Puppeteer integration with Hyperbrowser enables web scraping and automation through headless browser control.

Playwright | Hyperbrowser

The page discusses using Playwright with Hyperbrowser for web scraping and automation tasks.

Selenium | Hyperbrowser

Selenium integration with Hyperbrowser allows for enhanced web scraping and automation capabilities.

Overview | Hyperbrowser

Overview of Hyperbrowser, a tool for web scraping and automation, detailing its features and functionalities.

Session Parameters | Hyperbrowser

This page details session parameters for configuring Hyperbrowser's web scraping and automation features.

Advanced Privacy & Anti-Detection | Hyperbrowser

This page discusses Hyperbrowser's advanced privacy features and anti-detection capabilities for web scraping and automation.

Profiles | Hyperbrowser

The "Profiles" page in Hyperbrowser outlines how to manage user profiles for data scraping and automation tasks.

Recordings | Hyperbrowser

The page covers Hyperbrowser's recording feature for efficient web scraping and automation processes.

Live View | Hyperbrowser

The Live View feature in Hyperbrowser allows real-time monitoring and interaction with web scraping tasks.

Extensions | Hyperbrowser

The page discusses extensions for Hyperbrowser, enhancing its web scraping and automation capabilities.

Scrape | Hyperbrowser

"Scrape" page in Hyperbrowser documentation focuses on scraping data from web pages using the tool's features.

Crawl | Hyperbrowser

The page discusses how to utilize Hyperbrowser for effective web crawling.

Extract | Hyperbrowser

The Extract page of Hyperbrowser provides guidelines for web scraping and data extraction techniques using the tool.

Browser Use | Hyperbrowser

The page discusses using Hyperbrowser for web scraping and automation tasks via browser interactions.

Claude Computer Use | Hyperbrowser

The page provides guidelines on using Claude with Hyperbrowser for effective web scraping and automation.

OpenAI CUA | Hyperbrowser

The page discusses the integration of OpenAI's CUA with Hyperbrowser for enhanced web scraping and automation capabilities.

AI Function Calling | Hyperbrowser

The page discusses AI function calling features within Hyperbrowser for enhanced web scraping and automation.

Scraping | Hyperbrowser

The page covers web scraping techniques and documentation for using Hyperbrowser effectively.

Extract Information with an LLM | Hyperbrowser

Learn how to extract information using a Large Language Model with Hyperbrowser.

Using Hyperbrowser Session | Hyperbrowser

The page describes how to use sessions in Hyperbrowser for efficient web scraping and automation.

CAPTCHA Solving | Hyperbrowser

Hyperbrowser provides tools and guidance for CAPTCHA solving in web scraping and automation processes.

Model Context Protocol | Hyperbrowser

The page covers the Model Context Protocol used in Hyperbrowser for web scraping and automation.

SDKs | Hyperbrowser

The page discusses Hyperbrowser SDKs for web scraping and automation, including features and usage details.

Node | Hyperbrowser

Overview of the Node module in Hyperbrowser for web scraping and automation.

Sessions | Hyperbrowser

The page discusses sessions in Hyperbrowser, detailing how to manage and utilize them effectively for web scraping tasks.

Profiles | Hyperbrowser

The "Profiles" page of Hyperbrowser covers user profiles and their management within the tool.

Scrape | Hyperbrowser

The "Scrape" page of Hyperbrowser outlines techniques and tools for web scraping and automation.

Crawl | Hyperbrowser

The "Crawl" page of Hyperbrowser details how to use the tool for web scraping and automated data extraction.

Extensions | Hyperbrowser

The Extensions page for Hyperbrowser details available extensions that enhance web scraping and automation functionalities.

Python | Hyperbrowser

The page provides documentation on using Hyperbrowser with Python for web scraping and automation tasks.

Sessions | Hyperbrowser

The page discusses managing sessions in Hyperbrowser for effective web scraping and automation tasks.

Profiles | Hyperbrowser

The "Profiles" page in Hyperbrowser documentation explains how to manage and use user profiles for web scraping tasks.

Scrape | Hyperbrowser

The page explains how to use Hyperbrowser for web scraping tasks.

Crawl | Hyperbrowser

The Crawl section of Hyperbrowser’s documentation explains web scraping techniques and automation processes.

Extensions | Hyperbrowser

Explore Hyperbrowser extensions for enhanced web scraping and automation capabilities in your projects.

API Reference | Hyperbrowser

API Reference for Hyperbrowser provides detailed information on using its web scraping and automation features.

Sessions | Hyperbrowser

The "Sessions" page in Hyperbrowser covers managing and utilizing sessions for web scraping and automation tasks.

Crawl | Hyperbrowser

The "Crawl" section of Hyperbrowser documentation explains how to use the tool for web scraping and automation tasks.

Scrape | Hyperbrowser

The "Scrape" section of Hyperbrowser documentation explains web scraping techniques and automation features of the tool.

Extract | Hyperbrowser

The Extract page of Hyperbrowser provides guidelines on data extraction methods and tools for web scraping.

Agents | Hyperbrowser

The "Agents" page in Hyperbrowser documentation discusses automated entities for web scraping and task execution.

Browser Use | Hyperbrowser

The page explains how to effectively utilize browser features in Hyperbrowser for web scraping and automation tasks.

Claude Computer Use | Hyperbrowser

The page discusses using Claude for web scraping and automation with Hyperbrowser tools.

OpenAI CUA | Hyperbrowser

OpenAI CUA for Hyperbrowser details integration and automation features for effective web scraping.

Profiles | Hyperbrowser

The "Profiles" page in Hyperbrowser documentation explains how to manage and configure user profiles for scraping tasks.

Extensions | Hyperbrowser

The page discusses extensions for Hyperbrowser that enhance its web scraping and automation capabilities.

LangChain | Hyperbrowser

LangChain integrates with Hyperbrowser for enhanced web scraping and automation capabilities.

LlamaIndex | Hyperbrowser

LlamaIndex documentation for integrating with Hyperbrowser for web scraping and automation tasks.

Hyperbrowser

Hyperbrowser is a web scraping and automation tool, offering extensive documentation for users.

Related MCP Servers

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇