browser_launch
Launch a Chromium browser and establish a CDP session. Mandatory first step; supports headless mode or visual debugging and optional URL navigation.
Instructions
Launch a Chromium browser instance and establish a CDP session. This is the mandatory first step before any other tool can be used. By default, launches in headless mode. Set headless=false for visual debugging. If a URL is provided, the browser navigates to it immediately after launch (waits for load event). The launched session automatically enables: Accessibility domain, DOM domain, Performance domain, and Target.setAutoAttach for OOPIF discovery.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL to navigate to immediately after launch. | |
| headless | No | Launch in headless mode (default: true). Set false to see the browser window. | |
| userDataDir | No | Path to a persistent Chrome user profile directory. Useful for preserving cookies and localStorage across sessions. | |
| autoTrackHistory | No | Automatically record screenshots and build a visual markdown history report under the workspace artifacts directory (default: false). Note: This starts an implicit screen recording. If you later call browser_start_recording, the implicit recording will be stopped and replaced. | |
| sessionHistoryDir | No | Custom directory path to save the session history and screenshots (default: process.cwd()/session_history/sess_<timestamp>) |