list_headless_windows
List top-level windows on a specified off-screen desktop to inspect their handles, titles, sizes, and process details for headless GUI automation.
Instructions
List the top-level windows living on an off-screen desktop.
Args: params (HeadlessDesktopInput): desktop name.
Returns: str: JSON {"ok": true, "name": "...", "count": N, "windows": [ {handle, process_id, thread_id, dpi, title, class, width, height}, ...]}.
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": {
"params": "<params>"
},
"name": "list_headless_windows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |