console_click
Clicks, double-clicks, right-clicks, or scrolls at x,y on a running VM's current console screenshot to control installers and desktops that need mouse input.
Instructions
Click — or double-click, right-click, or turn the wheel (scroll: + up, − down) — on a running guest's screen at x, y of the latest console_screenshot picture (take a fresh one first: the click lands where things are now). For installers and desktops that need the mouse; keys (console_send) are surer where they work. The user sees a red mark where it will land. It needs an absolute pointer in the VM (a USB tablet; Linux also has QEMU's vmmouse): without one it says so and clicks nothing.
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": {
"host": "<host>",
"vmid": "<vmid>",
"x": "<x>",
"y": "<y>",
"reason": "<reason>"
},
"name": "console_click"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | ||
| y | Yes | ||
| host | Yes | The host's id, from list_hosts. | |
| vmid | Yes | The guest's ID (VMID). | |
| button | No | ||
| double | No | ||
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| scroll | No | Wheel steps instead of a click. |