job_start
Start a long-running shell command on a server in the background and return a job id right away. Use it for anything that can take more than about a minute — package installs, builds, backups, migrations, large downloads. The job keeps running after this call returns and survives the connection closing; its output goes to a log you read with job_status. The command runs from the login user's home directory. On a Windows server the command is PowerShell.
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": "job_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Server id (or exact name) from hosts_list | |
| command | Yes | Shell command to run in the background | |
| username | No | Login user (defaults to the server's user, else root). Use the same one for job_status/job_stop. |