desktop_snapshot
Capture a desktop accessibility tree as structured JSON with @ref IDs to inspect windows and UI elements for automation or verification.
Instructions
agent-desktop snapshot: Capture accessibility tree as structured JSON with @ref IDs
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": "desktop_snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Filter to application by name | |
| root | No | Start traversal from this ref instead of window root | |
| compact | No | Collapse single-child unnamed nodes to reduce tree depth | |
| surface | No | Surface to snapshot | window |
| skeleton | No | Shallow overview with children_count on truncated containers | |
| max_depth | No | Maximum tree depth (default 10) | |
| window_id | No | Scope to a single window ID (from list-windows) | |
| timeout_ms | No | Observation deadline in milliseconds (default 3000; raise for slow Chromium settles) | |
| include_bounds | No | Include element bounds (x, y, width, height) | |
| interactive_only | No | Include interactive elements only | |
| force_electron_a11y | No | Assume Chromium renderer accessibility is forced (skips activation guidance) |