pikvm_ssh
Run read-only SSH commands on PiKVM as root with safeguards; require confirmation for risky changes and block files containing secrets.
Instructions
Run one command on the PiKVM over SSH (as root).
Safe read-only commands run right away (cat of /etc/kvmd files, systemctl status, journalctl, df, uptime, ip a, vcgencmd measure_temp, kvmd -m, pacman -Q, ls, and pipes into head, tail, grep, wc). Anything else needs confirm=true after the user says yes. Risky ones (rm, reboot, pacman, pikvm-update, passwd, stopping services and similar) also need confirm_phrase equal to the first word of the command. Files with passwords or keys are blocked. The PiKVM disk is read-only. To change a config file use pikvm_config_write instead.
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": {
"command": "<command>"
},
"name": "pikvm_ssh"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| server | No | ||
| command | Yes | ||
| confirm | No | ||
| timeout | No | ||
| max_chars | No | ||
| confirm_phrase | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |