MCP tools
Copy page
This page lists the tools of the MCP server at /mcp. The assistant in the web UI uses the same tools.
A tool runs with the role of the API token. A mutating tool runs at once over MCP; in the assistant it waits for your confirmation. Results of execution tools are masked: a secret value shows as ***.
| Tool | Role | Mutating | MCP | Description |
|---|---|---|---|---|
list_namespaces |
viewer | no | yes | List all namespaces with their source type. |
list_flows |
viewer | no | yes | List the flows of a namespace and its children. An empty namespace lists all flows. |
get_flow |
viewer | no | yes | Read one flow with its YAML source. |
validate_flow |
viewer | no | yes | Validate the content of a flow or namespace file against the head version of the namespace. |
list_files |
viewer | no | yes | List the files of the head version of a namespace. |
read_file |
viewer | no | yes | Read one file of the head version of a namespace. |
list_executions |
viewer | no | yes | List recent executions, newest first. Filters: namespace, flow as <namespace>/<flow_id>, comma-separated states, and waiting for the executions with a task that waits for an answer. |
get_execution |
viewer | no | yes | Read one execution with its task runs. |
get_logs |
viewer | no | yes | Read the last log lines of an execution, optionally of one task. tail is 1 to 1000, default 200. grep keeps the lines that contain the text, case-insensitive. failed_only keeps the lines of the task runs that failed or timed out. |
get_metrics |
viewer | no | yes | Read the metrics of an execution. |
get_insight |
viewer | no | yes | Read the latest failure triage of an execution. |
trigger_execution |
operator | yes | yes | Start a flow with inputs and labels. |
cancel_execution |
operator | yes | yes | Cancel a running execution. |
rerun_execution |
operator | yes | yes | Start a new execution with the same snapshot, definition and inputs as another execution. The other execution can still run. |
restart_execution |
operator | yes | yes | Start a new execution that reuses the successful task runs of an ended execution that did not succeed. Only the failed, timed out, cancelled and skipped tasks run again. |
resume_execution |
operator | yes | yes | Answer a task in state WAITING, for example an approval. get_execution shows the message and the fields in task_runs[].wait. The values become the outputs of the task, and the tasks after it run. |
reject_execution |
operator | yes | yes | Refuse a task in state WAITING. The task run ends FAILED with reason rejected, and the tasks after it with run_if success are skipped. |
get_flow_schema |
viewer | no | yes | Read the JSON Schema of flow files (*.flow.yaml). Use it to write a valid flow. |
propose_change |
editor | no | no | Propose file changes of a namespace. The result has the validation issues and a diff. Nothing is written. |
apply_change |
editor | yes | yes | Apply file changes: a new version of a managed namespace, or a new branch of a git namespace. Invalid flows are refused. |
list_flows
Section titled “list_flows”| Argument | Type | Required | Description |
|---|---|---|---|
namespace |
string | no |
get_flow
Section titled “get_flow”| Argument | Type | Required | Description |
|---|---|---|---|
flow_id |
string | yes | |
namespace |
string | yes |
validate_flow
Section titled “validate_flow”| Argument | Type | Required | Description |
|---|---|---|---|
content |
string | yes | |
namespace |
string | yes | |
path |
string | yes |
list_files
Section titled “list_files”| Argument | Type | Required | Description |
|---|---|---|---|
namespace |
string | yes | Namespace name. |
read_file
Section titled “read_file”| Argument | Type | Required | Description |
|---|---|---|---|
namespace |
string | yes | |
path |
string | yes |
list_executions
Section titled “list_executions”| Argument | Type | Required | Description |
|---|---|---|---|
flow |
string | no | |
limit |
integer | no | |
namespace |
string | no | |
state |
string | no | |
waiting |
boolean | no |
get_execution
Section titled “get_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
get_logs
Section titled “get_logs”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | |
failed_only |
boolean | no | Keep the lines of failed and timed out task runs. |
grep |
string | no | Keep the lines that contain this text, case-insensitive. |
tail |
integer | no | |
task |
string | no |
get_metrics
Section titled “get_metrics”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
get_insight
Section titled “get_insight”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
trigger_execution
Section titled “trigger_execution”| Argument | Type | Required | Description |
|---|---|---|---|
flow_id |
string | yes | |
inputs |
object | no | |
labels |
object | no | |
namespace |
string | yes |
cancel_execution
Section titled “cancel_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
rerun_execution
Section titled “rerun_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
restart_execution
Section titled “restart_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
resume_execution
Section titled “resume_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
inputs |
object | no | Values of the fields of the wait task. |
task |
string | yes | ID of the waiting task. |
reject_execution
Section titled “reject_execution”| Argument | Type | Required | Description |
|---|---|---|---|
execution_id |
string | yes | Execution UUID. |
message |
string | no | The reason. |
task |
string | yes | ID of the waiting task. |
propose_change
Section titled “propose_change”| Argument | Type | Required | Description |
|---|---|---|---|
files |
array | yes | |
message |
string | yes | Version or commit message. |
namespace |
string | yes |
apply_change
Section titled “apply_change”| Argument | Type | Required | Description |
|---|---|---|---|
files |
array | yes | |
message |
string | yes | Version or commit message. |
namespace |
string | yes |