act
Perform a browser action like click, type, scroll, or navigate, then get back exactly what changed or a new view. Use it to drive real pages step by step with mouse and key events.
Instructions
Perform one action in a browser started with start_browser and get back what changed (~ changed, + added, - removed), or a new view after a navigation. Input is sent as real mouse and key events. Name the element by id from observe, or by role and name, or click a point with x and y. The first line of the answer says failed, blocked, challenge or stale when the action did not go through. stale: the ids are from a view that no longer exists, nothing was done, and a new view follows.
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": {
"browser_id": "<browser_id>",
"action": "<action>"
},
"name": "act"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | click: a viewport point instead of an element (with y). | |
| y | No | ||
| dy | No | scroll: pixels, positive is down. | |
| id | No | Target element id, from observe. | |
| ms | No | wait: a fixed time in milliseconds, at most 30000. | |
| to | No | scroll. | |
| for | No | wait: for text to appear, an element to go, or the URL to change. | |
| tab | No | Tab id. Default: the tab used last. | |
| url | No | navigate. | |
| keys | No | press: Enter, Escape, Control+A, or a sequence such as "Tab Tab Enter". | |
| name | No | ||
| role | No | With name: the first element with this role and name, instead of id. | |
| text | No | type: the text. wait for text: the text. dialog: the prompt answer. | |
| clear | No | type: empty the field first. | |
| files | No | upload: file paths on the browser's machine. | |
| right | No | click: right button. | |
| accept | No | dialog: accept (true) or dismiss. | |
| action | Yes | ||
| double | No | click: double click. | |
| option | No | select: option text or value. | |
| submit | No | type: press Enter afterwards. | |
| timeout | No | wait: milliseconds, default 10000, at most 30000. | |
| browser_id | Yes | The id returned by start_browser. |