List flows
List automated flows with status, trigger and the steps they contain.
MCP tool privy_read → list_flows
read
Returns each flow with its status, the trigger that starts it and its steps in order (email, sms, delay, split, tag, update_contact). It reads the flow and changes nothing; flows are built and published in the Privy flow builder.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | draft, active or inactive |
| page integer | integer | Page number, starting at 1 |
| per_page integer | integer | Items per page |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "privy_read",
"arguments": {
"operation": "list_flows",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"data": [
{
"id": "flw_2e71",
"title": "Welcome email",
"status": "active",
"trigger": "Customer subscribed to marketing",
"steps": [
"email",
"delay",
"email"
]
},
{
"id": "flw_90bb",
"title": "Abandoned cart",
"status": "inactive",
"trigger": "Cart abandoned",
"steps": [
"delay",
"email",
"email"
]
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total_count": 2,
"total_pages": 1
}
},
"isError": false
}