Skip to navigation

get_workflows

Read workflows, their actions, triggers and executions

Live server: available on mcp.solvimon.com as well as on the test server.

Read-only access to workflows and what they did. A workflow is an automation rule that watches for an event and runs actions in response. For example, when an invoice becomes overdue, a workflow emails the customer or pushes data to an ERP.

Actions: list, get, search

Resource types: workflows, workflow_actions, workflow_triggers, workflow_executions (get and search only)

  • A trigger only says the workflow matched an event. The execution says what happened: SUCCEEDED, FAILED (with the reason), PENDING or NOT_EXECUTED (its conditions didn’t hold).
  • Execution search needs at least one id filter, such as a customer, invoice or workflow.
  • Workflow search takes type and status filters only.
Did the overdue reminder go out for this invoice?
{"action": "search", "resource_type": "workflow_executions", "body": {"filter_fields": [{"name": "invoice_id", "value": "invo_Tq3mVx7RnW2kLb9YcHd45"}]}}

Only ACTIVE workflows and actions run. DRAFT configuration never fires.

Example prompts

  • “Which reminders and emails do we send customers automatically?”
  • “Did the overdue reminder go out for invoice INV-2026-10-000044?”
  • “Why didn’t Acme Inc. get a low-balance email?”
  • “Which workflow runs failed for Acme Inc., and why?”

Example output

Prompt: “Which reminders and emails do we send customers automatically?”

Tool call:

{"action": "list", "resource_type": "workflows", "filter": {"limit": "10"}}

Response (trimmed):

{
"data": [
{
"id": "work_JwDsM40vxDPmz0CEiX1t",
"name": "Invoice overdue reminder",
"type": "INVOICE",
"status": "DRAFT",
"invoice": {"variant": "OVERDUE", "overdue": {"periods": [{"type": "DAY", "value": 7}]}},
"desk_url": "https://test.desk.solvimon.com/plat_YwDsM40vxDPmp2CYio1I/workflow/work_JwDsM40vxDPmz0CEiX1t"
},
{
"id": "work_EwDsM40vxDPmzfCaix1i",
"name": "Payment failed notification",
"type": "PAYMENT",
"status": "DRAFT",
"payment": {"variant": "FAILED_PAYMENT"}
}
]
}

Claude’s answer: None right now. Six workflows are set up (final invoice email, overdue reminder after 7 days, failed payment, upcoming payment, trial ending and low wallet balance), but all are DRAFT, so none of them fires. Activate the ones you want in Desk.