List monitors and their runs
list_monitorsList the workspace's monitors -- searches and agent questions kept on a schedule -- each with its schedule, status, next run, this month's spend and what its last run found; or, with monitor_id, one monitor with its latest runs.
Call it to find a monitor_id, to see whether a kept search or question found something new, or to check spend. A run's refId is the search or agent run it made: get_job(kind='search' or 'agent', id=refId) reads it in full.
Inputs: kind keeps 'search' or 'agent' ones; monitor_id reads one, with up to runs of its runs (10 by default).
Read-only and free: it reads stored data and never fetches.
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": "list_monitors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Keep only 'search' or 'agent' monitors; omit for both. | |
| runs | No | With monitor_id: how many of its latest runs, 1 to 50; default 10. | |
| monitor_id | No | One monitor's id, to read it with its latest runs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| status | No | Only on a failure: the HTTP status code. | |
| monitor | No | With monitor_id only: the monitor in full -- its request, budget and records setting -- and under `runs` its latest runs, newest first, each {id, status, trigger, changed, summary, credits, refId, createdAt}. | |
| monitors | No | Each {id, kind, name, schedule, status, nextRunAt, lastRunAt, spentThisMonth, budget, lastRun: {status, changed, summary}}, newest first. Absent with monitor_id. |