Job Tools

Tools for inspecting Mission Control's background jobs, such as scrapers, notification senders and cleanup jobs, and their run history.

Permissions

All job tools need the job:read action. job:read grants all job history or none, and job details can mention resources the caller can't otherwise read.

list_jobs

List the jobs scheduled on this Mission Control server, with their cron schedule, last run and next run. Use list_job_runs for execution history.

Field	Description	Scheme
limit	Maximum number of jobs to return. Defaults to 50, maximum 100	number
name	Case-insensitive partial match against the job name or its aliases	string
resource_id	Exact resource ID filter	string
resource_type	Exact resource type filter	string

Example Usage

Prompt: "When does the Kubernetes scraper run next?"

Result: Returns the matching jobs with their schedule and next run time.

list_job_runs

List job run history, most recent first. Each run includes its status, success and error counts, duration and error messages. Use get_job_run for a run's full details.

Field	Description	Scheme
agent_id	Exact agent ID filter	string
before	Inclusive end time, as a datemath expression e.g. now-1h, or an RFC 3339 timestamp	string
has_errors	Return only runs with errors (true) or without errors (false)	boolean
limit	Maximum number of runs to return. Defaults to 20, maximum 100	number
name	Case-insensitive partial match against the job name	string
resource_id	Exact resource ID filter	string
resource_type	Exact resource type filter	string
since	Inclusive start time, as a datemath expression e.g. now-24h, or an RFC 3339 timestamp	string
status	Statuses to include: RUNNING, SUCCESS, WARNING, FAILED, STALE or SKIPPED	[]string

Example Usage

Prompt: "Which jobs failed in the last day?"

Parameters Used:

{
  "status": ["FAILED"],
  "since": "now-24h"
}

Result: Returns the failed runs with their error messages.

get_job_run

Get the complete record of a job run, including its details and errors.

Field	Description	Scheme
id*	Job run ID, from list_job_runs results	string

Example Usage

Prompt: "Why did that scraper run fail?"

Result: Returns the run's full details and every error it recorded.