UI accessibility snapshot
ui_snapshotUse this when the user needs to inspect native desktop Accessibility/UI Automation semantics for the active app before clicking or typing. Prefer scope=active; use scope=desktop only for cross-application discovery. For a Chromium web page with CDP available, prefer browser_snapshot for page DOM semantics.
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": {
"device": "<device>"
},
"name": "ui_snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Optional application/process name substring scope. | |
| pid | No | Optional owning process id scope. | |
| scope | No | Default active. Use desktop only when cross-application discovery is required. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| max_depth | No | Maximum traversal depth; default 8, maximum 32. | |
| max_nodes | No | Maximum nodes; default 500, maximum 5000. | |
| browser_dom | No | Prefer the native browser document accessibility subtree instead of browser chrome when supported. | |
| window_title | No | Optional top-level accessibility window/frame title scope. | |
| semantic_tree | No | Include compact semantic hierarchy text; default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | UI accessibility snapshot structured result for ui_snapshot. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload. | |
| text | Yes | Concise human-readable result of the tool call. |