Session
Session — MCP tools exposed to agents.
7 tools in this group.
browser_start
Start/activate the current session's browser without navigating (opens about:blank), creating the session if a named one does not yet exist. If the MCP server is configured with a remote WebDriver-BiDi endpoint, this connects to that endpoint instead of launching locally. To navigate to a page, use browser_open; to stop the session, use browser_stop.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_stop
Stop the current session's run: close its tabs/context and end its trace. The shared browser process and other sessions keep running (an isolated session closes its own dedicated browser). No-op if the session has no active browser. To start or re-run a session, use browser_start; to navigate, use browser_open; to close the browser entirely, use browser_quit.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_session_create
Create a named browser session with isolated cookies/storage (its own user context). Does not switch to it — use browser_session_use.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
isolated | boolean | no | false | Give this session its own dedicated browser process (crash isolation) |
name | string | yes | Session name: 1-64 characters of lowercase letters, digits, and hyphens |
browser_session_use
Switch this agent's current session: subsequent browser tools run in it unless they pass an explicit session argument.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of an existing session (or "default") |
browser_session_list
List active browser sessions with status, tab count, and idle time.
No parameters.
browser_session_close
Close a named browser session, its tabs, and its isolated storage.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the session to close |
browser_session_reset
Reset a named browser session: fresh storage and a fresh tab under the same name.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the session to reset |