ssh_list_jobs
List all jobs (running, finished, crashed) on SSH hosts with metadata. Filter by host to assess capacity before spawning new jobs.
Instructions
List every job registered on this mcp-ssh-live server — running, finished-but-not-yet-reaped, and crashed. Returns metadata only (job_id, cmd, host, label, started_at, finished_at, exit_status, status, pid, pty, stdout_lines, stderr_lines); use ssh_tail to fetch the actual output of a specific job.
Filter by host with the 'host' argument (alias or raw address). Pass include_finished=false to see only still-running jobs, which is typical when deciding whether to spawn a new one without hitting the max_jobs_per_host cap.
Finished jobs are kept in the registry for a grace window (reap_finished_after_sec, default 600 s) so you can still fetch their final tail output after they exit.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ssh_list_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | If provided, only return jobs whose host equals this alias OR whose raw address matches. If omitted or null, return jobs across every host. We resolve the filter against the config so a user who types the raw IP still gets jobs tagged with the configured alias. | |
| include_finished | No | When True (default), return jobs in every lifecycle state. When False, skip jobs that have already exited / crashed / been killed — useful for capacity planning. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||