get_sequence
Fetch one win-back sequence by id — its name, trigger, switch, its steps in order with the coupon each carries, and how it has done. Read-only.
Read one sequence as the creator built it: the steps in order, each with its stable id,
position, delay_days, the body with its placeholders unfilled, and the coupon it carries, plus
the counts all time. Same row as list_sequences;
list_sequence_enrollments has the
members behind the counts.
Read-only. Never mutates anything.
Step ids are stable
A step rewritten in place through update_sequence
keeps its id, and a member due it keeps their position. Read the ids here before rewriting the
list.
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 the sequence belongs to.
sequence_id*stringUUID of the sequence to fetch.
What 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 }}How it fails
RESOURCE_NOT_FOUNDunknown project_id or sequence_id, a sequence of another project, one the creator deleted, or a project outside the token's scope.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-sequence:view.
How is this guide?
Last updated on
delete_sequence
Put a win-back sequence out of use. Destructive; every member part-way through leaves it, the history stays for the figures, and the id stops answering. Emits sequence.deleted.
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.