Connect Hyperbrowser to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the run browser agent tool in Hyperbrowser
Use the web search tool in Hyperbrowser
Use the get session tool in Hyperbrowser
Use the get session recording tool in Hyperbrowser
Use the extract structured data tool in Hyperbrowser
Use the delete profile tool in Hyperbrowser
Supported Tools
run_browser_agent
Run Browser Agent
Run an AI browser agent that autonomously operates a browser to complete a natural language task.
Supports multiple agent types: **Browser Use** (fast, lightweight), **Claude Computer Use** (complex tasks), and **OpenAI CUA** (general-purpose).
Starts the agent task, waits for completion, and returns the final result and step-by-step history.
web_search
Web Search
Search the web using Bing and get structured search results.
Returns titles, URLs, and descriptions for matching web pages. Supports advanced filtering by file type, site, date, and geographic location.
get_session
Get Session
Retrieve details of an existing browser session including status, connection endpoints, and live view URL.
get_session_recording
Get Session Recording
Retrieve recording URLs for a stopped browser session.
Can get rrweb DOM-based replay recording URLs and MP4 video recording URLs. Video recordings must be explicitly enabled when creating the session.
extract_data
Extract Structured Data
Use AI to extract specific structured data from one or more webpages.
Provide URLs and a natural language prompt describing what data to extract, and optionally a JSON schema for the output structure.
The AI transforms unstructured web content into structured data matching your requirements.
delete_profile
Delete Profile
Permanently delete a browser profile. This removes all stored cookies, login state, and browser data associated with the profile.
create_profile
Create Profile
Create a new browser profile for persisting login state, cookies, and browser data across sessions.
Attach the created profile to sessions to maintain authenticated state.
scrape_webpage
Scrape Webpage
Scrape content from a single webpage and return it in structured formats (markdown, HTML, links, screenshot).
Starts a scrape job, waits for completion, and returns the extracted page content.
Supports configurable session options like proxy, stealth mode, and CAPTCHA solving.
crawl_website
Crawl Website
Crawl an entire website starting from a URL, following links to subpages and extracting content from each page.
Starts the crawl job, waits for completion, and returns all crawled page content. Useful for gathering data across an entire site.
list_profiles
List Profiles
List browser profiles with optional filtering by name and pagination.
batch_scrape
Batch Scrape
Scrape content from multiple webpages simultaneously in a single batch job.
Returns results for each URL in the same order as provided. Each page's content is available in markdown, HTML, links, or screenshot format.
list_sessions
List Sessions
List browser sessions with pagination. Returns session details including status and timestamps.
create_session
Create Browser Session
Create a new cloud browser session with configurable options.
Returns connection endpoints (WebSocket, WebDriver) and a live view URL for real-time observation.
The session can be connected to via Playwright, Puppeteer, or Selenium.
stop_session
Stop Session
Stop a running browser session. This terminates the browser and releases resources. Session recordings and downloads become available after stopping.
get_profile
Get Profile
Retrieve a saved browser profile by ID, including its name and timestamps. Call list_profiles to discover profile IDs.
stop_browser_agent_task
Stop Browser Agent Task
Stop an existing browser agent task to halt its actions. Use the same agent type that started the task. Call get_browser_agent_task afterward to inspect the final state.
get_browser_agent_task
Get Browser Agent Task
Retrieve the current status, final result, and execution history of an existing browser agent task. Use the same agent type that started the task.
Enable Hyperbrowser in Metorial. In your Metorial portal, enable the Hyperbrowser MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Hyperbrowser tools.
Enable Hyperbrowser in Metorial. In your Metorial portal, enable the Hyperbrowser MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Hyperbrowser tools.
Enable Hyperbrowser in Metorial. In your Metorial portal, enable the Hyperbrowser MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Hyperbrowser tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Hyperbrowser in Metorial. In your Metorial portal, enable the Hyperbrowser MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Hyperbrowser tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Hyperbrowser in Metorial. In your Metorial portal, enable the Hyperbrowser MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Hyperbrowser tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Hyperbrowser through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Hyperbrowser and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Hyperbrowser tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Manage cloud-based headless browser sessions for AI agents and web automation. Create, configure, and stop browser sessions with built-in stealth mode, proxy rotation, CAPTCHA solving, and anti-bot detection. Scrape web pages in markdown or HTML, crawl entire websites, and extract structured data using AI-powered schema-based extraction. Run autonomous AI browser agents (Browser Use, Claude Computer Use, OpenAI CUA, Gemini) that accept natural language tasks and operate a browser to complete them. Manage persistent browser profiles to maintain login state and cookies across sessions. Upload and attach Chrome extensions, retrieve downloaded files, perform web searches via Bing, capture session recordings, and observe live browser sessions in real-time.
Frequently asked questions
Common questions about connecting Hyperbrowser to AI agents with Metorial.
How many tools does the Hyperbrowser MCP server have?
The Hyperbrowser MCP server exposes 17 tools, including Run Browser Agent, Web Search, Get Session. Each one is governed and traced through Metorial.
Does the Hyperbrowser MCP server support triggers?
Hyperbrowser exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Hyperbrowser MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Hyperbrowser MCP server through the same Metorial URL.
How do I give only some teams access to Hyperbrowser?
Use role-based access control to decide which teams, users, and agents can use Hyperbrowser and which of its tools they can call.
Can I self-host the Hyperbrowser MCP server?
Yes. Metorial is open source, so you can run the Hyperbrowser MCP server yourself or use the hosted gateway.
Connect Hyperbrowser to production AI agents
See how Metorial gives your team governed access to Hyperbrowser, with tracing and security controls built in.