list_windows
Enumerate visible top-level Windows desktop windows, foreground first, returning hwnds, process names, screen rectangles, and occlusion/elevation status for UI tree reads or targeted window capture.
Instructions
List visible top-level windows, foreground first.
Returns hwnd, process name, rect in physical screen pixels, whether the
window is covered by another window (occluded), and whether it can only be
read by an elevated server (elevated). Titles are localized by Windows.
Use the hwnd with get_ui_tree and capture_window. hwnds are stable for the
lifetime of a window but change when the app is restarted.
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": "list_windows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_desktop | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |