browser_press
Sends key presses or modifier chords to a specified browser tab or element, enabling keyboard shortcuts and DOM-based input while keeping browser operations in the background.
Instructions
Press a key or chord such as ctrl+a, Return or shift+Left. Uses DOM editing in both browsers to preserve background operation. Trusted keyboard input is unsupported.
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": {
"tabId": "<tabId>",
"key": "<key>"
},
"name": "browser_press"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alt | No | ||
| key | Yes | ||
| ref | No | Element ref from the latest snapshot in this document. | |
| ctrl | No | ||
| meta | No | ||
| shift | No | ||
| tabId | Yes | Tab id from browser_tabs. | |
| expect | No | Post-action condition. Default timeout is 1.2 seconds in visible pages and 3 seconds in hidden pages. A mismatch does not undo the action; inspect before retrying. | |
| browser | No | Browser id from browser_list, or chrome/firefox when only one instance matches. | |
| frameId | No | Frame id from browser_frames; defaults to top frame. | |
| revision | No | Reject if the DOM revision differs from the snapshot. | |
| selector | No | CSS selector. Must identify exactly one element. | |
| inputMode | No | Auto uses trusted Chrome text insertion only in the active foreground tab; DOM otherwise. Pointer actions and keys always use DOM. | auto |
| documentId | No | Reject the action if this snapshot document has changed. |