list_guest_files
List files and folders inside a running Proxmox VM or container, including name, type, size, and modified time, to inspect guest storage before file operations.
Instructions
The files and folders in a folder of a running VM (through its QEMU guest agent) or container (over the host's SSH): name, folder or not, size, modified. Without folder: /home on Linux, C:\Users on Windows, /root in a container; on Windows an empty folder lists the drives.
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>",
"reason": "<reason>"
},
"name": "list_guest_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host's id, from list_hosts. | |
| vmid | Yes | The guest's ID (VMID). | |
| folder | No | ||
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. |