Skip to main content

Workflows

MCP tools for the Workflows module. See the Workflows module docs for permissions and data model.

list-workflows​

List workflows

Arguments​

ArgumentTypeRequiredDescription
project_idstringno—
limitnumbernoResults per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offsetnumbernoResults to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

create-workflow​

Create a workflow

Arguments​

ArgumentTypeRequiredDescription
project_idstringno—
namestringyes—
descriptionstring | nullno—
statesarray<object>yes—
transitionsarray<object>yes—
payload_schemaobject | nullno—
version_labelstringnoOptional tag for the version this create archives, e.g. initial.

get-workflow​

Get a workflow

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—

update-workflow​

Update a workflow

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—
namestringno—
descriptionstring | nullno—
statesarray<object>no—
transitionsarray<object>no—
payload_schemaobject | nullno—
version_labelstringnoOptional tag for the version this write archives, e.g. pre-rewire. Ignored when the write changes no definition field, since no version is archived.
expected_versionanynoRefuses the write unless the resource is at this version.

delete-workflow​

Delete a workflow

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—

list-workflow-versions​

List a workflow's versions

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—
limitnumbernoResults per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offsetnumbernoResults to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

get-workflow-version​

Fetch an archived workflow version

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—
versionnumberyesThe archived version number

restore-workflow-version​

Restore an archived workflow state machine

Arguments​

ArgumentTypeRequiredDescription
workflow_idstringyes—
versionnumberyesThe archived version number
labelstringnoOptional tag for the new version the restore archives. Defaults to restored from vN.