browser.create_session
Launch a new browser session with optional start URL, proxy settings, authentication profiles, and custom user agents for automated web interactions.
Instructions
Create a new browser session and optionally navigate to a start URL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| start_url | No | ||
| storage_state_path | No | ||
| auth_profile | No | ||
| proxy_server | No | ||
| proxy_username | No | ||
| proxy_password | No | ||
| user_agent | No | ||
| totp_secret | No |
Implementation Reference
- controller/app/tool_gateway.py:952-963 (handler)The _create_session method in McpToolGateway is the handler implementation for the "browser.create_session" MCP tool. It delegates the logic to the manager's create_session method.
async def _create_session(self, payload: CreateSessionRequest) -> dict[str, Any]: return await self.manager.create_session( name=payload.name, start_url=payload.start_url, storage_state_path=payload.storage_state_path, auth_profile=payload.auth_profile, request_proxy_server=payload.proxy_server, request_proxy_username=payload.proxy_username, request_proxy_password=payload.proxy_password, user_agent=payload.user_agent, totp_secret=payload.totp_secret, ) - controller/app/tool_gateway.py:337-342 (registration)Tool registration for "browser.create_session" within the McpToolGateway class.
ToolSpec( name="browser.create_session", description="Create a new browser session and optionally navigate to a start URL.", input_model=CreateSessionRequest, handler=self._create_session, ),