Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
A MCP server implementation for hyperbrowser.
Attribute | Details |
---|---|
Docker Image | mcp/hyperbrowser |
Author | hyperbrowserai |
Repository | https://github.com/hyperbrowserai/mcp |
Dockerfile | https://github.com/hyperbrowserai/mcp/blob/main/Dockerfile |
Docker Image built by | Docker Inc. |
Docker Scout Health Score | |
Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/hyperbrowser --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
Licence | MIT License |
Tools provided by this Server | Short Description |
---|---|
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. |
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. |
crawl_webpages | Crawl a website starting from a URL and explore linked pages. |
create_profile | Creates a new persistent Hyperbrowser profile. |
delete_profile | Deletes an existing persistent Hyperbrowser profile. |
extract_structured_data | Extract structured data from a webpage. |
list_profiles | Lists existing persistent Hyperbrowser profiles, with optional pagination. |
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. |
scrape_webpage | Scrape a webpage and extract its content in various formats. |
search_with_bing | Search the web using Bing. |
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:
Best suited use cases include:
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.
Parameters | Type | Description |
---|---|---|
task | string | The task to perform inside the browser |
maxSteps | integer optional | |
returnStepInfo | boolean optional | Whether 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. |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
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:
Best suited use cases include:
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.
Parameters | Type | Description |
---|---|---|
task | string | The task to perform inside the browser |
maxSteps | integer optional | |
returnStepInfo | boolean optional | Whether 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. |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
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.
Parameters | Type | Description |
---|---|---|
followLinks | boolean | Whether to follow links on the crawled webpages |
outputFormat | array | The format of the output |
url | string | The URL of the webpage to crawl. |
ignoreSitemap | boolean optional | |
maxPages | integer optional | |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
create_profile
Creates a new persistent Hyperbrowser profile.
delete_profile
Deletes an existing persistent Hyperbrowser profile.
Parameters | Type | Description |
---|---|---|
profileId | string | ID of the profile to delete |
extract_structured_data
Extract structured data from a webpage. This tool allows you to extract structured data from a webpage using a schema.
Parameters | Type | Description |
---|---|---|
prompt | string | The prompt to use for the extraction |
urls | array | The list of URLs of the webpages to extract structured information from. Can include wildcards (e.g. https://example.com/*) |
schema | string optional | The json schema to use for the extraction. Must provide an object describing a spec compliant json schema, any other types are invalid. |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
list_profiles
Lists existing persistent Hyperbrowser profiles, with optional pagination.
Parameters | Type | Description |
---|---|---|
limit | integer optional | Number of profiles per page (optional) |
page | integer optional | Page number for pagination (optional) |
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:
Best suited use cases include:
Provide a clear step-by-step description, necessary context, and expected outcomes. Returns the completed result or an error message if issues arise.
Parameters | Type | Description |
---|---|---|
task | string | The task to perform inside the browser |
maxSteps | integer optional | |
returnStepInfo | boolean optional | Whether 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. |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
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.
Parameters | Type | Description |
---|---|---|
outputFormat | array | The format of the output |
url | string | The URL of the webpage to scrape |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
search_with_bing
Search the web using Bing. This tool allows you to search the web using bing.com
Parameters | Type | Description |
---|---|---|
query | string | The search query to submit to Bing |
numResults | integer optional | Number of search results to return |
sessionOptions | object optional | Options for the browser session. Avoid setting these if not mentioned explicitly |
{
"mcpServers": {
"hyperbrowser": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYPERBROWSER_API_KEY",
"mcp/hyperbrowser"
],
"env": {
"HYPERBROWSER_API_KEY": "<app or user token>"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for