click_element
Clicks a page element with real mouse input after scrolling it into view, waiting for it to appear or be enabled. Fails without clicking when the element is hidden, covered, or disabled.
Instructions
Clicks an element with real mouse input after scrolling it into view; waits up to 2 s for a CSS selector's element to appear or be enabled, and fails without clicking when it is hidden, covered (naming the overlay) or disabled. A dialog or breakpoint the click triggers is noted in the reply ({dialog} or {paused, location}), not an error: continue with handle_dialog or resume (evaluate_on_call_frame, with --tool-groups debug, reads the paused frame).
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": {
"selector": "<selector>"
},
"name": "click_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| button | No | Mouse button ('right' opens context menus). Default: 'left'. | |
| tab_id | No | Default: the active tab. | |
| selector | Yes | CSS selector, 'host >>> inner' (into an open shadow root or same-origin iframe) or snapshot ref (e12). | |
| modifiers | No | Keys held during the click. | |
| click_count | No | 1, 2 (double click) or 3. Default: 1. | |
| instance_id | No | Default: 'default'. |