chrome_use_click
Clicks a page element via CSS selector or @ref, or clicks a viewport coordinate, enabling precise browser interactions in Chrome.
Instructions
Click an element (by CSS selector or @ref) or a raw viewport coordinate. Provide either selector or both x and y.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Viewport x coordinate (use with y instead of selector). | |
| y | No | Viewport y coordinate (use with x instead of selector). | |
| force | No | With tabId: act on a tab this session does not own (the user's own, or another session's), in place and in the background (--tab <handle> --force). Only when the user asked you to act on that tab; the result has forced: true and the tab's title and url. | |
| tabId | No | Target tab id (e.g. t2), label, or targetId (--tab). | |
| follow | No | If the click opens a new tab, switch the active tab to it. | |
| newTab | No | Report a tab opened by this click without switching to it. | |
| observe | No | Observe the action's effect (--observe): a page snapshot before and after, the change, and whether the page now waits for a person. Use it when the action should submit, save, pay or send, then confirm the effect with chrome_use_expect. | |
| session | No | Isolated session name (chrome-use --session <name>). Each session gets its own tab group, browser tab and element refs. Omit it unless several agents share ONE MCP server — the session is otherwise derived per agent automatically. When you do share a server with sibling agents, pass a name unique to you on every call, or you will drive their tabs and invalidate their refs. | |
| selector | No | CSS selector or @ref to click. | |
| timeoutMs | No | Kill the underlying chrome-use process if it hasn't responded after this many ms (default 30000). |