list_schedules

List the recurring agent launches, most recently updated first, with each one's cron expression, prompt, workflow, next run time, and its latest run.

Scheduleread-onlyidempotentMCP tool

Returns one page; pass the response's nextPageToken back as pagination.cursor for the next. The summary this returns by default holds only the opening of each schedule's prompt, marked by promptTruncated; get_schedule returns one whole, and view VIEW_FULL returns every prompt on the page.

Calling it#

curl -X POST http://127.0.0.1:8787/schedule.v1.ScheduleService/ListSchedules \
  -H 'Content-Type: application/json' \
  -d '{}'

komrad rpc list-schedules

{
  "name": "list_schedules",
  "arguments": {}
}

Offered by the komrad MCP server to orchestrator agents.

Request#

ListSchedulesRequest#

Field	Type	Description
`pagination`	Pagination	Where to carry on from.
`view`	View	How much of each record to return, since the panel draws every field and a model reading the same endpoint has a context window to spend.

Response#

ListSchedulesResponse#

Field	Type	Description
`schedules`	list of Schedule	One page of schedules, most recently updated first.
`nextPageToken`	string	Pass this back as the pagination cursor for the next page.

Types#

Pagination#

Field Type Description

Field	Type	Description
`limit`	int32	How many rows to return, capped by the server, and left to the server entirely when unset.
`cursor`	string	The next_page_token a previous reply carried, or unset to start from the beginning. at most 2048 characters

limit

int32

How many rows to return, capped by the server, and left to the server entirely when unset.

cursor

string

The next_page_token a previous reply carried, or unset to start from the beginning.

at most 2048 characters

Schedule#

Field	Type	Description
`id`	string	The handle every other call names this schedule by.
`name`	string	What the panel lists it as.
`cron`	string	Five fields saying when it fires, in the timezone below.
`timezone`	string	Which clock the expression is read against, blank for the machine's own.
`enabled`	bool	Whether it is armed, since a paused schedule keeps its record and stops firing.
`hideAgents`	bool	Whether its launches stay out of the panel's sidebar while still running.
`prompt`	string	The opening prompt every agent it launches is given.
`workflowId`	string	Which workflow its agents are filed under, deciding their directory and flags.
`nextRunAt`	timestamp	When the expression next matches, unset while the schedule is paused.
`promptTruncated`	bool	Whether prompt holds only its opening, which a summary listing returns.
`latestRun`	ScheduleRun	The newest firing still on record, unset when it has never fired or the record has aged out.
`recentRuns`	list of ScheduleRun	The newest firings on record, newest first, which only the watch fills.

ScheduleRun#

ScheduleRun is one firing of a schedule, as the job that carried it out stands.

Field	Type	Description
`id`	int64	The job's own id, which orders firings newest first.
`scheduledFor`	timestamp	Which occurrence of the cron expression this firing stands for.
`state`	ScheduleRunState	Where the firing stands.
`attempt`	int32	Which try this is, starting at one once it has been worked.
`maxAttempts`	int32	How many tries it is given before it is discarded.
`finalizedAt`	timestamp	When it finished, unset while it is still waiting or working.
`message`	string	Why it was skipped or what its last failed attempt said, blank once it has launched.

View#

View is how much of each record a listing returns, so that the panel, which draws every field, and a model reading the same endpoint through a context window ask for different amounts of the same rows.

Value	Description
`VIEW_SUMMARY`	Long text is cut to its opening, and the record says which fields were cut.
`VIEW_FULL`	Every field whole, however long.

ScheduleRunState#

ScheduleRunState is where River holds a firing's job.

Value	Description
`SCHEDULE_RUN_STATE_AVAILABLE`	Waiting for a worker to pick it up.
`SCHEDULE_RUN_STATE_PENDING`	Held back from running until something releases it.
`SCHEDULE_RUN_STATE_SCHEDULED`	Queued to become available at a later time.
`SCHEDULE_RUN_STATE_RUNNING`	Being worked right now.
`SCHEDULE_RUN_STATE_RETRYABLE`	Failed an attempt and waiting to try again.
`SCHEDULE_RUN_STATE_COMPLETED`	Launched its agent.
`SCHEDULE_RUN_STATE_CANCELLED`	Skipped on purpose, with the reason in its message.
`SCHEDULE_RUN_STATE_DISCARDED`	Ran out of attempts, with the last error in its message.