Notifications

Generated automatically at build time from the madtea repository - do not edit here. Source: docs/reference/notifications.md.

CLI Commands

madtea notifications list

List notifications

FlagTypeDefaultDescription
--allboolfalseInclude read notifications
--beforestringOnly show notifications updated before this time (YYYY-MM-DD or RFC3339)
--limitint0Maximum number of items to return (0 = server default)
--pageint0Page number for pagination (0 = first page)
--sincestringOnly show notifications updated after this time (YYYY-MM-DD or RFC3339)
--status-typesstringSlice[]Filter by status: read, unread, pinned
--subject-typestringSlice[]Filter by subject: issue, pull, commit, repository

madtea notifications new

Get count of unread notifications

madtea notifications read

Mark notification as read

madtea notifications read-all

Mark all notifications as read

FlagTypeDefaultDescription
--last-read-atstringISO 8601 timestamp cutoff

madtea notifications repo

List notifications for a repository

FlagTypeDefaultDescription
--limitint0Maximum number of items to return (0 = server default)
--pageint0Page number for pagination (0 = first page)
--repostringRepository (owner/repo)

madtea notifications repo-read

Mark all notifications for a repository as read

FlagTypeDefaultDescription
--repostringRepository (owner/repo)

MCP Tools

madt_notifications

Manage authenticated user notifications (requires madt_enable(domains=[“notifications”])): list, mark read, count unread, scope to repository.

Output schema: declared

One tool, action-dispatched. Set action to one of:

action="list"

List notifications. By default shows unread only; set all=true to include read.

Optional: all, status_types, subject_type, since, before, limit, page

action="new"

Get count of unread notifications.

action="read"

Mark notifications as read. Pass thread_id for a single notification, or all=true to mark all.

One of: thread_id | all

Optional: last_read_at

action="repo"

List notifications for a specific repository.

Required: repo

Optional: limit, page

action="repo_read"

Mark all notifications for a repository as read.

Required: repo

Canonical source: docs/reference/notifications.md in the madtea repo.