Orchestration

Browse MCP domains.

Runs

Start, list, inspect, cancel, and resume agent, task, and workflow runs, follow their events, answer their input requests, and find the runs that schedules, webhooks, and evaluations start.

Lifecycle

Create, list, get, cancel, pause, and resume runs, ensure child runs, and read account run analytics.

ToolDescription
List conversation runsList conversation runs.
List project runsList project runs.
List runsList runs; bound runtimes need own project_id, trigger_type=["schedule"] and trigger_id.
Get runGet run details: status, errors, target, timing, token usage and cost, by run UUID or public id.
Get run analyticsReturn account run analytics.
Create runCreate a run.
Update runUpdate a run.
Delete runDelete a run.
Cancel runCancel a run.
Finalize runFinalize a run.
Ensure child runCreate or recover the child run of a parent run tool call.
Fail runFail a run.
Pause runPause a run.
Resume runResume a run.
Succeed runSucceed a run.

Events

Append, read, summarize, and stream run events, and list the event types.

ToolDescription
List run event typesList run event types.
List run eventsRead run event details: errors, steps, model calls and tool results, paginated by canonical UUID.
Get run eventRead one recorded event by canonical run UUID and numeric event_id.
Get run event summaryCount run events by type and time bucket without event bodies or usage metrics.
Get run snapshotRead a run replay snapshot by canonical UUID; use event readers for targeted failure analysis.
Append run eventsAppend run events.
Stream run eventsStream run events.

Input requests

Create, find, cancel, and respond to the input requests a run waits for.

ToolDescription
List conversation input requestsList conversation input requests.
List run input requestsList run input requests.
Get input requestReturn an input request.
Create input requestCreate an input request.
Respond to input requestRespond to input request.
Cancel input requestCancel an input request.

Children

List the child runs a run starts.

ToolDescription
List child runsList direct child runs by canonical parent UUID; follow page_info.next for further children.
List conversation child runsList conversation child runs.

Triggers

Start runs from schedules, webhooks, and evaluations, and list the runs they started.

ToolDescription
List project webhook runsList webhook runs.
List webhook eventsList the events a webhook received, newest first, to check deliveries, manual runs and replays; returns one page of webhook events, each with the run it started, if any, and an event that the filter stopped has the status ignored.
Create scheduled runRun a schedule now.
Run webhookSend a test payload to a webhook as an external sender posts it, to check its target and filter, also when the webhook is a draft or disabled; returns the webhook event that the call created.
List evaluation run projectionsList the runs of one eval, newest first by default, to follow their status or pick a run to inspect; returns one page of eval runs.
List evaluation runsList evaluation runs.
Get evaluation runRead one run of an eval to follow its status or read its result summary; returns the eval run.
Get evaluation run reportRead the report of a finished eval run to inspect every example and metric result; returns the report document, or a conflict while the report is not written yet.
Run evaluationStart a run of an eval against its agent, reading the eval from the project or a preview branch and running it on the main branch, an environment or a preview branch; returns the new eval run, which finishes in the background.

Runtime

Renew the execution lease, delegate event-writer tokens to child runs, acknowledge cancellation stops and pauses, and read pause checkpoints. A worker or runtime calls these with the credential its claim or dispatch issued.

ToolDescription
Create run event tokenIssue a short-lived credential that appends events to a direct child run.
Send run heartbeatRenew the execution lease of the current run generation.

Tools

ToolDescription
List connected agentsList a project's connected agents: every push runtime service first, then at most the 50 most recently updated pull workers, with no continuation for the rest.
List conversation message branchesList the child messages of a message, oldest first, which are the alternative continuations that start at it; to show the alternatives to an edited message, list the children of the parent of that message.
List conversation messagesList the messages of a conversation in sequence order, including branches, to render or replay a thread; returns one page of messages, paged with the returned cursor until it is null.
List conversation participantsList the users and agents in a conversation with their roles and read cursors to show who is in a thread; returns every participant in one page.
List conversationsList the conversations the caller can read, newest activity first, to build a conversation picker or to find a conversation of a project; returns one page of conversations, filtered by project reference and paged with the returned cursor until it is null.
List schedulesList the schedules stored for a project, newest first, to find a schedule or check its state and last runs; returns one page of schedules.
List source schedulesList the schedules declared in the source files of a project, a branch or an environment to see what can be activated; returns every declared schedule as one page with the discovery diagnostics.
List source webhooksList the webhooks declared in the source files of a project, a branch or an environment to see what a deployment creates; returns the declared webhooks, the discovery diagnostics and the source files that could not be read, without pagination.
List webhooksList the webhooks stored for a project, newest first, to find a webhook or its public URL; returns one page of webhooks, or every webhook when neither a limit nor a cursor is sent.
Get conversationGet one conversation before rendering a thread or to check its status, title and project; returns the conversation with its participants and its current branch head.
Get conversation messageGet one message of a conversation to refresh a single message, for example after streaming finishes; returns the message.
Get conversation read stateGet the read cursor and the unread count of the caller for a conversation to show unread badges; returns the last read message and the number of unread messages.
Get scheduleRead one schedule by its ID to inspect its target, cron expression, runtime target, state and last failure; returns the schedule.
Get webhookRead one webhook by its ID to inspect its target, prompt template, event filter and status; returns the webhook with its public URL and never its secret.
Create conversationStart a conversation in a project when a user or an agent opens a new thread, optionally with a first user message; a retry with the same idempotency key returns the same conversation.
Create conversation messageAdd a user message to a conversation to send what the user typed; the parent message defaults to the selected branch and an idempotency key makes retries safe.
Create conversation message branchCreate a sibling of a message with new parts when the user edits an earlier message and wants to keep the original reply; the new message gets the parent and role of the original and becomes the selected branch.
Create conversation participantAdd a user to a conversation as member or viewer to share a thread; the operation needs the admin relation.
Create scheduleCreate a recurring schedule that starts a task, a workflow or an agent on a cron expression, or, on REST and GraphQL only, activate a schedule declared in source (the MCP tool creates manual schedules only); returns the schedule: a new schedule is active, and a source schedule that was activated before keeps its current status.
Create webhookCreate a webhook when an external service must start an agent, task or workflow run, or when its deliveries must only be stored as webhook events; returns the webhook and its secret, which is shown only once.
Update agent push runtime serviceDrain or resume a runtime service.
Update conversationChange the title, summary, project or status (active or archived) of a conversation, for example to rename or archive a thread; a change of status, summary or project needs the admin relation.
Update conversation branch selectionSelect which branch is the current path of a conversation after the user switches branches, so that later messages continue from the selected message; returns the ID of the selected message.
Update conversation messageReplace the parts of an existing message to edit it in place; to keep the original, create a branch instead.
Update conversation read stateAdvance the read cursor of the caller to a message of the conversation when the user has seen messages; the cursor never moves backwards.
Update scheduleChange the fields of a schedule, or pause and resume it with the status, where an omitted field keeps its value; returns the updated schedule.
Update webhookChange the name, target, prompt template, event filter or status of a webhook, for example to enable or disable deliveries; returns the updated webhook.
Delete conversationDelete a conversation only when the user asks to remove the thread, so that it and its messages are no longer accessible; the deletion cannot be undone through the API and needs the admin relation.
Delete conversation messageDelete one message from a conversation only when the user asks to remove that message; the deletion needs editor access.
Delete conversation participantRemove a user from a conversation to revoke the access of that participant to the thread; the operation needs the admin relation.
Delete scheduleDelete a schedule that is no longer needed so that it starts no more runs; returns the acknowledgement ok: true.
Delete webhookDelete a webhook that is no longer needed so that its URL refuses future deliveries; returns ok true once the webhook is deleted.
Replay webhook eventSend the stored payload of a webhook event to the current target of the webhook again, for example after a failed run; returns the new webhook event that the replay created.