Creator Task Tools
A creator task is a grant no connector can hand over: a perk the creator delivers by hand once a purchase entitles a member to it.
A creator task is a grant no connector can hand over: a perk the creator delivers by hand once a purchase entitles a member to it. These tools list what is waiting and mark a task complete, which is what releases the member's grant.
Tools
complete_creator_task
DESTRUCTIVEMark a hand-arranged perk as handed over, so the subscriber's grant is issued and announced.
Records that the creator did the thing a manual perk needed: the task is marked done by the token's user, the access ledger row moves from pending to granted, and creator_task.completed then member.resource_added are raised for the grant. Use it after the creator confirms they handed the perk over — never to tidy the list.
It records a fact about the real world
Completing a task says the member received their perk. Read the task back with
list_creator_tasks and confirm with the creator first.
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.
Fires events
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it.
Arguments
task_id*stringUUID of the task to complete, from `list_creator_tasks` or the `creator_task.opened` event.
What it returns
{ "data": { "id": "9e4b2c71-3d58-4a6f-b0e2-7c1d5f8a9b34", "grant_id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4", "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6", "resource_title": "Welcome packet", "instructions": "Give Ada Lovelace access to Welcome packet.", "due_at": null, "completed_at": "2026-09-12T10:35:00+00:00", "completed_by_user_id": "0a7d3c1e-5b28-4f96-a3e1-6d9c2b8f4e10", "created_at": "2026-09-12T10:05:30+00:00" }}How it fails
VALIDATION_FAILEDthe task is already done, or its purchase has ended so there is nothing left to grant.
RESOURCE_NOT_FOUNDunknown task_id, or a task outside the token's scope.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-subscription:update.
List the hand-arranged perks a creator still has to hand over — one task per subscriber and manual resource — or the ones already done.
A manual resource is a perk no connector can give, so a purchase that includes one opens a task for the creator and the access waits. This lists those tasks for one project: by default the open ones (not yet done, purchase still standing), oldest first, so the longest-waiting member is at the top. Read it to answer "who is still waiting for something I hand over myself?".
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 tasks to list.
statusstringoptionalWhich tasks: `open` (default: not yet done, purchase still standing), `completed`, or `all`.
opencompletedalllimitintegeroptionalTasks per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "9e4b2c71-3d58-4a6f-b0e2-7c1d5f8a9b34", "grant_id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4", "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6", "resource_title": "Welcome packet", "instructions": "Give Ada Lovelace access to Welcome packet.", "due_at": null, "completed_at": null, "completed_by_user_id": null, "created_at": "2026-09-12T10:05:30Z" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
RESOURCE_NOT_FOUNDproject_id is not a project the token can see.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-subscription:view.
How is this guide?
Coupon Tools
A coupon is one code many buyers can redeem for money off at checkout, the multi-use counterpart of an access code.
Disaster Recovery Tools
Disaster Recovery is Subscriby's answer to a connector outage or a lost channel: what the probes found, what was recovered and whether it can still be undone.