list_sequences
List a project's win-back sequences with their steps in order and how each has done. Read-only. Paginated, narrowed to running or paused sequences or to one trigger.
Discover a project's win-back sequences: the ordered messages a member who leaves receives on the
days the creator chose. Each row carries the steps in order and the counts all time: every
member ever enrolled, the members still receiving steps, those who received every step and those a
payment brought back while they were enrolled. Use it to find a sequence id before
get_sequence,
update_sequence or
delete_sequence.
Read-only. Never mutates anything.
A paused sequence keeps its rows
active: false lists the sequences switched off; their steps and counts stay, and switching one
back on enrols nobody retroactively.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose sequences to list.
activebooleanoptionalOptional: true for running sequences only, false for paused ones only. Omit for both.
triggerstringoptionalOptional: keep the sequences on one trigger, such as "churned".
limitintegeroptionalMaximum sequences to return per page (1..100).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "9d2f4b6a-1c3e-4f58-8a7b-6e5d4c3b2a19", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "name": "Win-back after churn", "trigger": "churned", "active": true, "steps": [ { "id": "4e8a2c6d-7b1f-4d93-a5c0-8f2e1b7d6c54", "position": 1, "delay_days": 3, "body": "Hi {name}, your place in {project} is still here whenever you want it back: {link}", "coupon": null }, { "id": "b1c7e9f3-2a4d-4e86-9b0c-5d7f8a2e1c43", "position": 2, "delay_days": 7, "body": "Still thinking it over? {coupon} takes {discount} off your first month back: {link}", "coupon": { "id": "3b7c9d1e-5f24-4a86-9c0b-2d4e6f8a1b3c", "code": "COMEBACK20" } } ], "counts": { "enrolled": 12, "open": 4, "completed": 6, "won_back": 2 }, "created_at": "2026-10-01T09:00:00+00:00", "updated_at": "2026-10-10T08:00:00+00:00", "deleted_at": null } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
VALIDATION_FAILEDa trigger that is not one of the values, or limit outside 1..100.
RESOURCE_NOT_FOUNDunknown project_id, or the project is outside the token's scope.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-sequence:view-any.
How is this guide?
Last updated on
list_sequence_enrollments
List the passages members made through one win-back sequence — when they entered, the step due next, and how the passage ended if it has. Read-only. Paginated, narrowed by the way out.
update_sequence
Change a win-back sequence's name, trigger or switch, and replace its steps whole when given. Only the arguments present move. Emits sequence.updated.