ssh_run_command
Execute a single non-interactive shell command on a remote host and return stdout, stderr, exit code, and duration; supply host_id, command, and timeout_seconds.
Instructions
Run a single non-interactive shell command on a remote host. Returns stdout, stderr, exit code, and duration. Call host_list first — it returns the uid of every host, and that value is what host_id expects. The model must use host_id only; connection credentials are resolved server-side and never returned. The model MUST supply timeout_seconds (1-600) appropriate for the command; the command is terminated when the timeout expires.
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_id": "<host_id>",
"command": "<command>",
"timeout_seconds": "<timeout_seconds>"
},
"name": "ssh_run_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | Shell command to execute on the remote host. | |
| host_id | Yes | Identifier of an existing host: the exact `uid` value returned by `host_list`. Call `host_list` first and pass that value unchanged. | |
| timeout_seconds | Yes | Hard timeout in seconds. REQUIRED. The model must estimate an appropriate timeout based on the command's complexity (1-600 seconds). The command is terminated when the timeout expires. |