hyper-browser

name

hyper-browser

description

Hyperbrowser is a browser-as-a-service platform that enables developers and AI agents to run scalable, cloud-hosted browser sessions for web automation, scraping, and interaction—handling infrastructure, anti-bot bypass, session management, and real-time control via APIs and SDKs. Read and write Hyper Browser data through One: extractjobs, sessions, scrapejobs, browserusetasks, geminicomputerusetasks, claudecomputerusetasks and more, 52 actions with real parameter documentation. Use whenever the user asks to look something up in Hyper Browser, create or update a record there, or build code against the Hyper Browser API.

Hyper Browser through One

Hyperbrowser is a browser-as-a-service platform that enables developers and AI agents to run scalable, cloud-hosted browser sessions for web automation, scraping, and interaction—handling infrastructure, anti-bot bypass, session management, and real-time control via APIs and SDKs.

One exposes Hyper Browser through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform hyper-browser if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Hyper Browser is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Hyper Browser account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

ExtractJobs

Action	Method	Path	Action id
Get Extract Job Status	GET	/api/extract/{{id}}/status	conn_mod_def::GKI00M_PGhg::Va3tJo6_Q1CjCeN3lod9tA
Get Extract Job Status and Results	GET	/api/extract/{{id}}	conn_mod_def::GKI00NQ9Qdg::KKlg5gvdQ-eG_j8WC_WUqA
Start an Extract Job	POST	/api/extract	conn_mod_def::GKI01ESWH4g::8oMzU0TCTESN-KHMUK2KmA

Sessions

Action	Method	Path	Action id
List Sessions	GET	/api/sessions	conn_mod_def::GKI00UwTtXA::1QPk4Tg_RdCv3s5pWjIALQ
Create New Session	POST	/api/session	conn_mod_def::GKI0zsd79jA::tH2Ze6A5TTGaUJ2e5macEg
Stop a Session	PUT	/api/session/{{id}}/stop	conn_mod_def::GKI01LVlLpg::rHldDZgTQzuhA3v7uf9pcg

ScrapeJobs

Action	Method	Path	Action id
Get a Scrape Job's Status	GET	/api/scrape/{{id}}/status	conn_mod_def::GKI00eljtkA::-m44yfK3T8WVhnjuvLqBHw
Get Scrape Job Status and Result	GET	/api/scrape/{{id}}	conn_mod_def::GKI00d6SFtA::6ypDs5ZqTm216ReerxkbUw
Create a New Scrape Job	POST	/api/scrape	conn_mod_def::GKI0zsVwKHA::zTgsUddFTMiNhYolNrzCdA

BrowserUseTasks

Action	Method	Path	Action id
Get Browser Use Task Status and Results	GET	/api/task/browser-use/{{id}}	conn_mod_def::GKI00DyhpGg::VilHTfB8TGWDchgntGh8-w
Start a Browser Use Task	POST	/api/task/browser-use	conn_mod_def::GKI00yYWTAA::LQkV3k1eRVStQlD42LKvNQ
Stop a Browser Use Task	PUT	/api/task/browser-use/{{id}}/stop	conn_mod_def::GKI01D05uUg::KBTHetneSzmzrWt9bOwWHA

GeminiComputerUseTasks

Action	Method	Path	Action id
Get Gemini Computer Use Task Status and Results	GET	/api/task/gemini-computer-use/{{id}}	conn_mod_def::GKI00V73JIg::XcCkFWmhS42iGKg6Ftke4g
Start a Gemini Computer Use Task	POST	/api/task/gemini-computer-use	conn_mod_def::GKI0070zM_A::_ddz5r2ZQ921YRf7FmVV8w
Stop a Gemini Computer Use Task	PUT	/api/task/gemini-computer-use/{{id}}/stop	conn_mod_def::GKI01D79x9g::W_B38OLOS8mi-7I9FsY-HQ

ClaudeComputerUseTasks

Action	Method	Path	Action id
Get Claude Computer Use Task Status and Results	GET	/api/task/claude-computer-use/{{id}}	conn_mod_def::GKI00FKgl9g::wTiNUGOmRUeAAqIEY5qe_A
Start a Claude Computer Use Task	POST	/api/task/claude-computer-use	conn_mod_def::GKI00yYykkg::D14mOnxGS0K9TQsKtRzqsA
Stop a Claude Computer Use Task	PUT	/api/task/claude-computer-use/{{id}}/stop	conn_mod_def::GKI01EGzWog::hRnX4woXRayqETQAQM9lSA

HyperAgentTasks

Action	Method	Path	Action id
Get HyperAgent Task Status and Results	GET	/api/task/hyper-agent/{{id}}	conn_mod_def::GKI00U-LllA::oIGnzdefTAa4mxKsBeIl5g
Start a HyperAgent Task	POST	/api/task/hyper-agent	conn_mod_def::GKI008Rxd1g::vlvDaWOtQOWSxi4_3PKVuQ
Stop a HyperAgent Task	PUT	/api/task/hyper-agent/{{id}}/stop	conn_mod_def::GKI01MCu89g::2dqE7qvKRjaQjlZ2huqzLA

BatchScrapeJobs

Action	Method	Path	Action id
Get Batch Scrape Job Status	GET	/api/scrape/batch/{{id}}/status	conn_mod_def::GKI0z2Y2d8g::ViqtBNnPTcmXhD41IJzUgQ
Get Batch Scrape Job Status and Results	GET	/api/scrape/batch/{{id}}	conn_mod_def::GKI0z2Y7fPA::N9efvFzhS4ulJ0VAhhr2Kg
Start a Batch Scrape Job	POST	/api/scrape/batch	conn_mod_def::GKI00yOvNxA::Dd6Kps66SP2MzzGxXwj0jw

CuaTasks

Action	Method	Path	Action id
Get a CUA Task's Status and Results	GET	/api/task/cua/{{id}}	conn_mod_def::GKI00NTrc5g::Sptnv6kLR7-yXxl0urYopw
Start a CUA Task	POST	/api/task/cua	conn_mod_def::GKI008GdIag::QWG8kCI4R96-iv8YSnm0jA
Stop a CUA Task	PUT	/api/task/cua/{{id}}/stop	conn_mod_def::GKI01DWrUkA::Qyppcx5WRESc8BXN83hRdA

CrawlJobs

Action	Method	Path	Action id
Get a Crawl Job's Status and Results	GET	/api/crawl/{{id}}	conn_mod_def::GKI00D7ny6g::L6UlZcRMQde8lYmVJ1CPjA
Get Crawl Job Status	GET	/api/crawl/{{id}}/status	conn_mod_def::GKI00DJ1SZA::Okiz6OBDSIybU-0MSf2cQQ
Start a Crawl Job	POST	/api/crawl	conn_mod_def::GKI007Uovxg::-AJCEbTCTjeSnMQXQua7lw

Extensions

Action	Method	Path	Action id
List All Extensions	GET	/api/extensions/list	conn_mod_def::GKI00mTPWqA::nZLTUDmWQrWGIYsAKDeuEw
Add a New Extension	POST	/api/extensions/add	conn_mod_def::GKI0ztxDvXg::Bwbu-yoBRfGf9r2lO35PGg

Profiles

Action	Method	Path	Action id
List Profiles	GET	/api/profiles	conn_mod_def::GKI00VZ0YtA::ca3QybZWSh2TEpCMoY4A9g
Create a Profile	POST	/api/profile	conn_mod_def::GKI0zrkEcKA::WIeungK3REyXvQttLV1iSQ

Profile

Action	Method	Path	Action id
Get Profile By ID	GET	/api/profile/{{id}}	conn_mod_def::GKI00dsx6Fg::LC5VmjViS9ydgCrDzRnnkQ
Delete a Profile by ID	DELETE	/api/profile/{{id}}	conn_mod_def::GKI0zsLzj7A::rjgI3vrYTBGU9vpTSfd3pA

WebFetch

Action	Method	Path	Action id
Fetch a Web Page	POST	/api/web/fetch	conn_mod_def::GKI0z5BoGog::wHiMlqQ4RYCG_1cyZI25Ug
Fetch a Web Page with X402 Payment	POST	/x402/web/fetch	conn_mod_def::GKI0z7caVqA::TUL5qm4_RaKv6BFm4i6IdQ

WebCrawlJobs

Action	Method	Path	Action id
Get a Web Crawl Job's Status	GET	/api/web/crawl/{{id}}/status	conn_mod_def::GKI00mRJOrA::eNis2wXcSzuLBMOQf7jJYQ
Start a Web Crawl Job	POST	/api/web/crawl	conn_mod_def::GKI008A4u2A::FyLlhP_PQg6ETo1ATtu_gA

WebSearch

Action	Method	Path	Action id
Search the Web	POST	/api/web/search	conn_mod_def::GKI00vzwPUA::gddCFCa5QLWSLEH-vmsoyw
Search the Web with X402 Payment	POST	/x402/web/search	conn_mod_def::GKI00w3DFAg::V3z0Yx8YSoC5NDoyEgUwVw

BrowserUseTaskStatus

Action	Method	Path	Action id
Get Browser Use Task Status	GET	/api/task/browser-use/{{id}}/status	conn_mod_def::GKI0z2JPlPA::LlM8eKidSYeEI2tL0oZ1rw

ClaudeComputerUseTaskStatus

Action	Method	Path	Action id
Get Claude Computer Use Task Status	GET	/api/task/claude-computer-use/{{id}}/status	conn_mod_def::GKI00FkwIMg::OaOLvsnpQdiVsAovWa8DpA

CuaTaskStatus

Action	Method	Path	Action id
Get a CUA Task's Status	GET	/api/task/cua/{{id}}/status	conn_mod_def::GKI00NFAaRA::s6AU2ghWSgKEJbudPTyp4g

GeminiComputerUseTaskStatus

Action	Method	Path	Action id
Get Gemini Computer Use Task Status	GET	/api/task/gemini-computer-use/{{id}}/status	conn_mod_def::GKI00NijpVA::VpBsNXs9Rby0hgQxOZ_5rQ

HyperAgentTaskStatus

Action	Method	Path	Action id
Get HyperAgent Task Status	GET	/api/task/hyper-agent/{{id}}/status	conn_mod_def::GKI00VmIt1A::JAETsxsXRGKNNMPzBR8AyA

Session

Action	Method	Path	Action id
Get Session by ID	GET	/api/session/{{id}}	conn_mod_def::GKI00dQqoxA::9fKUBk9wQpioWBs7vRnhow

SessionDownloadsUrl

Action	Method	Path	Action id
Get a Session's Downloads URL	GET	/api/session/{{id}}/downloads-url	conn_mod_def::GKI00eGhBIA::SDvKAyNGQpm8L0gm_MN6qQ

SessionRecordingUrl

Action	Method	Path	Action id
Get a Session Recording URL	GET	/api/session/{{id}}/recording-url	conn_mod_def::GKI00meGukA::Np9FgpwbSmysHEGxdLRVxw

WebCrawlJobResults

Action	Method	Path	Action id
Get Web Crawl Job Results	GET	/api/web/crawl/{{id}}	conn_mod_def::GKI00nMl8oA::G2MSsEOvQbam2YeaEqwsRQ

SessionVideoRecordingUrl

Action	Method	Path	Action id
Get a Session Video Recording URL	GET	/api/session/{{id}}/video-recording-url	conn_mod_def::GKI00ongjQA::Irda40uRTCCzBcSOjs1Wzw

When a call fails

The error comes from Hyper Browser, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/hyper-browser

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.