> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edgelab.su/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> MCP tools для уведомлений: список, отметка как прочитанное и счётчик непрочитанных

# Notifications

Уведомления удобны для фонового агента: по ним он понимает, что в EdgeLab появилось что-то новое и стоит отреагировать.

## Доступные tools

| Tool                     | Доступ | Что делает                                                  |
| ------------------------ | ------ | ----------------------------------------------------------- |
| `list_notifications`     | Edge+  | Возвращает список уведомлений                               |
| `mark_notification_read` | Edge+  | Помечает уведомление как прочитанное                        |
| `get_unread_count`       | Edge+  | Возвращает количество непрочитанных                         |
| `get_dashboard`          | Free   | Даёт общий сводный экран, где уведомления обычно тоже видны |

## `list_notifications`

Основной tool для чтения уведомлений.

Обычно полезные аргументы:

* `unread_only`
* `limit`
* `page` или аналогичная пагинация, если клиент её поддерживает

Типичные типы уведомлений:

* системные
* по событиям
* по support
* по progress
* по contributions
* по network

## `mark_notification_read`

Нужен после того, как агент уже обработал событие и не хочет поднимать его повторно.

### Пример вызова

```json theme={null}
{
  "name": "mark_notification_read",
  "arguments": {
    "notification_id": 123
  }
}
```

## `get_unread_count`

Самый дешёвый по смыслу polling tool. Идеален для cron:

1. вызвать `get_unread_count`
2. если `0`, закончить цикл
3. если `> 0`, вызвать `list_notifications`

Так агент не тратит лишний лимит на полную выборку.

## `get_dashboard`

Это не чисто notification tool, но он удобен как агрегатор. Если тебе нужен сводный снимок аккаунта с быстрым контекстом, начни с него.

## Практика

Для фонового агента обычно достаточно такого цикла:

```text theme={null}
get_unread_count -> list_notifications -> обработка -> mark_notification_read
```