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.
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 | |||