chrome_use_snapshot
Capture the current page's accessibility tree with @ref handles to locate elements for clicking, filling, or typing.
Instructions
Accessibility tree of the current page with @ref handles, for locating elements to click/fill/type.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "chrome_use_snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| diff | No | Only changes since this session last read the same page with the same options (--diff). Without a valid baseline returns the full tree and a diffNote. Omit or false for a full snapshot. Valid deltas include only excerpt refs; unchanged deltas have empty refs while the live session map is kept. | |
| urls | No | Include link/image URLs (-u). | |
| depth | No | Limit tree depth (-d). | |
| 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). | |
| cursor | No | Include the current cursor position marker (-C). | |
| filter | No | Regex: keep only matching lines + ancestor context (-f). | |
| compact | No | Remove empty structural elements (-c). | |
| 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 | Scope the snapshot to a CSS selector (-s). | |
| timeoutMs | No | Kill the underlying chrome-use process if it hasn't responded after this many ms (default 30000). | |
| interactive | No | Only interactive elements (-i). | |
| includeHidden | No | Keep text a person can't see on the page (off-screen, transparent, clipped, zero-size). Left out by default and counted in hiddenText/a note, because pages hide instructions aimed at agents there (--include-hidden). |