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 |
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/hyperbrowserai/mcp/blob/7492e83cf1825b3cf9725bfa25c5086df702599a/Dockerfile |
| Commit | 7492e83cf1825b3cf9725bfa25c5086df702599a |
| 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_agentThis 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 | integeroptional | |
returnStepInfo | booleanoptional | 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 | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
claude_computer_use_agentThis 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 | integeroptional | |
returnStepInfo | booleanoptional | 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 | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
crawl_webpagesCrawl 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 | booleanoptional | |
maxPages | integeroptional | |
sessionOptions | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
create_profileCreates a new persistent Hyperbrowser profile.
delete_profileDeletes an existing persistent Hyperbrowser profile.
| Parameters | Type | Description |
|---|---|---|
profileId | string | ID of the profile to delete |
extract_structured_dataExtract 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 | stringoptional | The json schema to use for the extraction. Must provide an object describing a spec compliant json schema, any other types are invalid. |
sessionOptions | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
list_profilesLists existing persistent Hyperbrowser profiles, with optional pagination.
| Parameters | Type | Description |
|---|---|---|
limit | integeroptional | Number of profiles per page (optional) |
page | integeroptional | Page number for pagination (optional) |
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. 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 | integeroptional | |
returnStepInfo | booleanoptional | 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 | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
scrape_webpageScrape 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 | objectoptional | Options for the browser session. Avoid setting these if not mentioned explicitly |
search_with_bingSearch 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 | integeroptional | Number of search results to return |
sessionOptions | objectoptional | 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>"
}
}
}
}