host_command
Run root shell commands on a Proxmox host over SSH to handle tasks the API cannot, such as checking services, logs, files, or installed programs, and return output and exit codes.
Instructions
Run a shell command on the Proxmox host itself, as root, over the SSH key the user set up in Proxmox Controller, and get its output and exit code — for what the API cannot do (installed programs, services, logs, files). One command line a request: the user sees it as it is in the approval window, every time. It runs on the host at the address the app connects to.
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>",
"command": "<command>",
"reason": "<reason>"
},
"name": "host_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host's id, from list_hosts. | |
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| command | Yes | A shell command line, run by the user's shell on the host (pipes and ; work). | |
| timeout_s | No |