click_element
Performs a verified click on a specific element in the current frame. Requires a CSS selector that matches exactly one visible element, with explicit confirmation to authorize side effects.
Instructions
Performs one verified, auditable click in the currently selected frame. Use it when the task requires activating a known button, link, or control after selecting the correct page/frame and identifying a CSS selector; it is the preferred minimal interaction primitive over arbitrary evaluate_script code. It does not discover elements, type text, or silently guess among matches: the selector must resolve to exactly one element unless index is explicit, and the chosen element must be visible. A click can submit data, navigate, or trigger external effects, so confirm=true is required and the result reports the exact resolved element.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| index | No | Explicit zero-based match index. Required when the selector matches more than one element. | |
| button | No | Mouse button. Defaults to left. | left |
| confirm | No | Must be true to authorize this specific click because it can submit data, navigate, or trigger external side effects. | |
| timeout | No | Maximum wait time in milliseconds. If set to 0, the default timeout will be used. | |
| selector | Yes | CSS selector evaluated only in the currently selected frame. Use select_frame first when the target is inside an iframe. | |
| modifiers | No | Optional keyboard modifiers held during the click. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | ||
| tool | Yes | Stable MCP tool name. | |
| error | No | ||
| summary | Yes | Concise human-readable outcome. |