Hyperbrowser

Hyperbrowser

A MCP server implementation for hyperbrowser.

3.3K

10 Tools

Packaged by
Requires Secrets
Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Use cases

About

Hyperbrowser MCP Server

A MCP server implementation for hyperbrowser.

What is an MCP Server?

Characteristics

AttributeDetails
Docker Imagemcp/hyperbrowser
Authorhyperbrowserai
Repositoryhttps://github.com/hyperbrowserai/mcp
Dockerfilehttps://github.com/hyperbrowserai/mcp/blob/main/Dockerfile
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/hyperbrowser --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceMIT License

Available Tools (10)

Tools provided by this ServerShort Description
browser_use_agentThis tool employs an open-source browser automation agent optimized specifically for fast, efficient, and cost-effective browser tasks using a cloud browser.
claude_computer_use_agentThis tool leverages Anthropic's Claude model to autonomously execute complex browser tasks with sophisticated reasoning capabilities using a cloud browser.
crawl_webpagesCrawl a website starting from a URL and explore linked pages.
create_profileCreates a new persistent Hyperbrowser profile.
delete_profileDeletes an existing persistent Hyperbrowser profile.
extract_structured_dataExtract structured data from a webpage.
list_profilesLists existing persistent Hyperbrowser profiles, with optional pagination.
openai_computer_use_agentThis tool utilizes OpenAI's model to autonomously execute general-purpose browser-based tasks with balanced performance and reliability using a cloud browser.
scrape_webpageScrape a webpage and extract its content in various formats.
search_with_bingSearch the web using Bing.

Tools Details

Tool: 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 flexibility for significantly faster performance and lower costs compared to Claude and OpenAI agents.

ParametersTypeDescription
taskstringThe task to perform inside the browser
maxStepsintegeroptional
returnStepInfobooleanoptionalWhether to return step-by-step information about the task.Should be false by default. May contain excessive information, so we strongly recommend setting this to false.
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: 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.

ParametersTypeDescription
taskstringThe task to perform inside the browser
maxStepsintegeroptional
returnStepInfobooleanoptionalWhether to return step-by-step information about the task.Should be false by default. May contain excessive information, so we strongly recommend setting this to false.
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: 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.

ParametersTypeDescription
followLinksbooleanWhether to follow links on the crawled webpages
outputFormatarrayThe format of the output
urlstringThe URL of the webpage to crawl.
ignoreSitemapbooleanoptional
maxPagesintegeroptional
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: create_profile

Creates a new persistent Hyperbrowser profile.

Tool: delete_profile

Deletes an existing persistent Hyperbrowser profile.

ParametersTypeDescription
profileIdstringID of the profile to delete

Tool: extract_structured_data

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

ParametersTypeDescription
promptstringThe prompt to use for the extraction
urlsarrayThe list of URLs of the webpages to extract structured information from. Can include wildcards (e.g. https://example.com/*)
schemastringoptionalThe json schema to use for the extraction. Must provide an object describing a spec compliant json schema, any other types are invalid.
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: list_profiles

Lists existing persistent Hyperbrowser profiles, with optional pagination.

ParametersTypeDescription
limitintegeroptionalNumber of profiles per page (optional)
pageintegeroptionalPage number for pagination (optional)

Tool: 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.

ParametersTypeDescription
taskstringThe task to perform inside the browser
maxStepsintegeroptional
returnStepInfobooleanoptionalWhether to return step-by-step information about the task.Should be false by default. May contain excessive information, so we strongly recommend setting this to false.
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: 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.

ParametersTypeDescription
outputFormatarrayThe format of the output
urlstringThe URL of the webpage to scrape
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Tool: search_with_bing

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

ParametersTypeDescription
querystringThe search query to submit to Bing
numResultsintegeroptionalNumber of search results to return
sessionOptionsobjectoptionalOptions for the browser session. Avoid setting these if not mentioned explicitly

Use this MCP Server

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HYPERBROWSER_API_KEY",
        "mcp/hyperbrowser"
      ],
      "env": {
        "HYPERBROWSER_API_KEY": "<app or user token>"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Manual installation

You can install the MCP server using:

Installation for

Related servers