For tools and AI agents: this page as Markdown · the public OpenAPI file
Description
Lists all flows, drafts and paused flows included, so an assistant can find the flowId to read or change. Flows that are not offered as tools are listed too.
Permission
Needs an API key or OAuth connection with the build permission.
Input
This tool takes no arguments.
Returns
count and flows (each with id, name, status, mode, triggerType, nodeCount and updatedAt).
Errors
Returned as a JSON-RPC error:
| Code | HTTP | Message |
|---|---|---|
| -32001 | 403 | API key lacks the 'build' permission required for flow authoring tools |
Messages are shown exactly as the server sends them, in English. A value in angle brackets is filled in at run time.
Examples
Example call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "exo_list_flows",
"arguments": {}
}
}curl -X POST https://exomations.com/api/mcp \
-H "X-Api-Key: exo_your_key" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"exo_list_flows","arguments":{}}}'Example result
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "1 flow(s) in your tenant.\n{ ... }"
}
],
"structuredContent": {
"count": 1,
"flows": [
{
"id": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61",
"name": "Overdue invoice reminders",
"status": "active",
"mode": "orchestration",
"triggerType": "webhook",
"nodeCount": 2,
"updatedAt": "2026-11-15T14:02:51.000Z"
}
]
},
"isError": false
}
}Example values. In content, the text after the summary line is the same data as structuredContent.