ssh_exec
Run a single shell command on one of your servers and return its combined output and exit code. Runs keyless over Termalin's tunnel — no SSH key, and the server needs no open inbound port. Each call is a fresh shell (cd does not persist — chain with &&). On a Windows server the command is PowerShell (PowerShell 7 when installed, else Windows PowerShell 5.1); a program's stderr comes back as plain text and the exit code is the program's own. A call waits 60 seconds by default; pass 'timeout' (seconds, up to 300) for a bit longer, e.g. a sleep plus some work. Some chat apps stop waiting sooner than that, so for anything long (installs, builds, backups) use job_start and check on it with job_status.
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>"
},
"name": "ssh_exec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Server id from hosts_list | |
| command | Yes | Shell command to execute | |
| timeout | No | Max seconds to wait for the command (default 60, at most 300). When it runs out, the answer says so; use job_start for long work. | |
| username | No | Login user (defaults to the tunnel's user, else root) | |
| timeoutSeconds | No | Same as 'timeout' (older name). |