start_session
Starts a browser session in the user's own signed-in browser when no tab is shared, letting an agent work in a separate window or on the current tab after user approval.
Instructions
Start working in the user's own browser (their logins and cookies) when no tab is shared yet. mode=window (default) opens a separate window for you, so the user's tabs are left alone; every tab you open in it is yours. mode=current asks to use the tab the user is looking at, for tasks about the page they're on. The user approves in a prompt (up to two minutes). Returns the tab handle and a snapshot.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"reason": "<reason>"
},
"name": "start_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | For mode=window: the page to open first. | |
| mode | No | ||
| reason | Yes | One sentence the user will read, saying what you're about to do. | |
| browser | No | Browser key when several are connected. |