skein_notifications
Your notification inbox — the bell feed of what happened on the issues and projects you watch. Everything here is per-user: you only ever see and change your own rows. By default a row is a summary, not the change itself: long old/new values are cut to fit the row budget and marked valuesTruncated when they were (see below for where the full value lives).
action="inbox" reads the feed (scope unread | all | archived, cursor-paginated); its first page of unread / all also lists your pending space invitations (no token or link — a person accepts them in the web UI). Only rows of projects you can access now are shown. Four actions clear unread state at four widths — mark_read for one row, mark_read_issue for everything on one issue including its comments, mark_read_card for everything on one Watching card (the issue's own notifications plus its descendants' when you watch it with its subtree — inside and outside the Watching window; answers {"marked": N}), mark_read_all for the whole backlog (optionally scoped to one project). archive moves one row out of the inbox into the archive view; read it back with inbox + scope="archived". Read-only actions: inbox.
Retention: notifications are kept NOTIFICATIONS_RETENTION_DAYS days (90 by default). A background sweep, at least once an hour, deletes a row that is not a mention and is older than that window, read or not, archived or not — EXCEPT a row whose web push is still owed (queued or being delivered): it stays, and is visible in the feed, until the delivery is over. A mention is never deleted, whatever its age.
What an inbox row does NOT carry in full: on a field-change notification the oldValue / newValue pair is cut to fit the row's size budget, and a row whose values were actually cut carries valuesTruncated: true. A row without that key was not cut, so the marker means «there is more», never «this might be all». The two halves of the pair then differ, and the difference decides whether reading on is possible at all. newValue is the entity's CURRENT state, so the route is the entity the row points at: read the issue with skein_show, or, for a comment notification, that comment with skein_comment_get(commentId). oldValue has NO route: the previous value is not on the card (it was overwritten) and no MCP tool returns it — skein_show(includeEvents:true) names the field that changed and who changed it, not what it held before. On that half the truncated preview is all there is; when you need the whole of a long old value, open the issue's activity in the web UI. The row's summary also has the entity reference removed where the row already names the entity, so the same id is not carried twice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "skein_notifications"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Only read by inbox: page size 1..100, default 25. | |
| scope | No | Only read by inbox: which rows to return — unread (default) | all | archived. | unread |
| action | Yes | What to do: - "inbox" → list your notifications; `scope` picks unread (default), all or archived. - "mark_read" → mark the ONE notification named by `notificationId` as read. - "mark_read_issue" → mark every notification tied to `issueId` read, comments on it included. - "mark_read_card" → mark every notification on the Watching card `issueId` read: the notifications whose card is that issue, its descendants' events included when you watch it with its subtree. - "mark_read_all" → mark every unread notification read; `projectId` narrows the sweep to one project. - "archive" → move the notification named by `notificationId` out of the inbox (sets archived_at and read_at). | |
| cursor | No | Only read by inbox: opaque cursor from the previous page (nextCursor). | |
| issueId | No | Full hierarchical issue id, e.g. "demo-42" or "demo-42.1". Required for mark_read_issue and mark_read_card. | |
| projectId | No | Project UUID. On inbox it narrows the listing to that project; on mark_read_all it narrows the sweep. Optional in both — omit for every project. | |
| notificationId | No | Notification id (positive integer), as returned by inbox. Required for mark_read and archive. Rejected by mark_read_issue, mark_read_card and mark_read_all, which act on more than one row by definition. |