Run a saved workflow
workflow_runRun one saved workflow by id and return what every step produced. Get the id and the input keys from workflow_list. Each step costs the credits its own tool costs, normally 1 per step, and the credit for this call counts as the first step's rather than being charged on top. Steps run in order and stop at the first failure; the result says which step stopped it and what was spent up to that point. Check the "substitutions" field when it is present: it lists values a step supplied that the tool replaced with its own, which means the run succeeded on a value you did not send. Requires an API key, because a workflow belongs to an account. Get a key in one request with POST https://toolforte.com/api/v1/keys/bootstrap and {"email":"you@example.com"}, which emails it to that address, or create one at https://toolforte.com/developers, and send it on the MCP connection as the header Authorization: Bearer tf_...
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workflowId": "<workflowId>"
},
"name": "workflow_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | Values for the workflow's declared inputs, keyed by the input key that workflow_list reports. Omit for a workflow that declares none. | |
| workflowId | Yes | The id of a workflow from workflow_list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | Whether the run completed | |
| name | No | ||
| runId | No | ||
| steps | No | What each step produced | |
| output | No | The final output of the workflow | |
| result | No | The result, when it is not an object | |
| stepsRun | No | ||
| durationMs | No | ||
| workflowId | No | ||
| stepsDefined | No | ||
| creditsCharged | No | Credits spent by this call |