MCP tools — Flows
Four tools for stateful conversational flows (cart abandonment, in-conversation menus, customer service triage).
Flows are stateful conversational responses with timeouts in minutes (default 30). Use them for cart abandonment, in-conversation quick-reply menus, and triage. Distinct from Sequences (multi-day drips).
| Tool | Annotation | Purpose |
|---|---|---|
list_flows |
IsReadOnly, IsIdempotent |
Filter by status |
get_flow |
IsReadOnly, IsIdempotent |
Graph + sessions |
create_flow |
IsDestructive(false) |
New flow (draft) — needs an entry template with quick reply buttons |
trigger_flow |
IsDestructive(false) |
Enroll a contact in a published flow |
list_flows
List automation flows. Filter by status (draft or published).
get_flow
Get flow details with graph, trigger template, active sessions.
| Input | Type |
|---|---|
id |
UUID |
create_flow
Create a new flow. Requires trigger template with quick reply buttons. Created as draft.
| Input | Type | Notes |
|---|---|---|
name |
string | required |
entry_template_id |
UUID | the template that opens the conversation — must have QUICK_REPLY buttons |
graph |
object | {nodes, edges} |
settings.session_ttl_minutes |
integer | default 30 |
Like sequences, flows are draft until published in the dashboard.
trigger_flow
Trigger a published flow for a specific contact.
| Input | Type | Notes |
|---|---|---|
flow_id |
UUID | must be published |
contact_id |
UUID | one of |
phone |
string | one of |
context |
object | optional |
Returns {id, status: "started"} or {status: "already_running"}.