List windows
list_windowsUse this when the user needs to discover top-level desktop windows or obtain a stable window id/PID/bounds before window_action, screenshot_region or targeted input. Use ui_snapshot instead when you need controls inside a window; prefer list_windows over screenshot-based window guessing.
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": "list_windows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| include_monitor | No | Enrich each window with monitor and monitor_index; default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Top-level windows. | |
| text | Yes | Concise human-readable result of the tool call. |