mcp-yandex-audience
MCP serverProductivityMCP server for Yandex Audience API: segments (CRM, lookalike, pixel), pixels, grants.
This server has no hosted endpoint yet, so ahel can't serve it. You can still add it. It stays paused until ahel can serve it.
Serve it through your gateway
One link, every agent. Your own credentials, stored once.
Tools it gives your agents (20)
| Tool | What it does |
|---|---|
| auth_status | Показывает, подключены ли Яндекс Аудитории: есть ли токен, откуда он взят (переменная окружения YANDEX_AUDIENCE_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. |
| start_login | Первый шаг подключения Яндекс Аудиторий без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. |
| finish_login | Второй шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к Аудиториям. |
| logout | Удаляет сохранённый токен Аудиторий с диска. Токен, заданный переменной окружения YANDEX_AUDIENCE_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. |
| list_segments | Возвращает список сегментов Яндекс Аудиторий, доступных пользователю (все типы: uploading, metrika, appmetrica, lookalike, geo, pixel). |
| upload_segment_file | Создаёт сегмент из TSV/TXT-файла с данными: идентификаторы устройств (IDFA/GAID), MAC-адреса или SHA256-хеши, по одной записи в строке; минимум 100 записей, до 1 ГБ, UTF-8. |
| upload_segment_csv_file | Создаёт сегмент из CSV-файла с CRM-данными. Первая строка — заголовок: колонки email, phone, ext_id (или external_id) и произвольные дополнительные поля; минимум 100 записей, до 1 ГБ. |
| confirm_segment | Сохраняет сегмент, созданный из файла (второй шаг после upload_segment_file / upload_segment_csv_file): задаёт имя, тип содержимого и параметры хеширования. |
| rename_segment | Изменяет сегмент. В схеме изменения доступно только поле name, так что фактически это переименование. Работает с сегментом любого типа; ответ — {"segment": {...}} с обновлёнными данными. |
| delete_segment | Удаляет указанный сегмент Яндекс Аудиторий. Операция необратима (метода восстановления сегмента в API нет). Успешный ответ — {"success": true}. |
| create_lookalike_segment | Создаёт сегмент типа lookalike — пользователи, «похожие» по поведению в интернете на аудиторию исходного сегмента (lookalike_link). |
| create_pixel_segment | Создаёт сегмент типа pixel — пользователи, которых пиксель (pixel_id из list_pixels) видел за последние period_length дней (1..90). |
| list_pixels | Возвращает список пикселей Яндекс Аудиторий пользователя. Ответ — {"pixels": [...]}: у каждого пикселя id, name, create_time, url (код пикселя для вставки в рекламные материалы), охваты... |
| create_pixel | Создаёт пиксель Яндекс Аудиторий с заданным именем. В ответе — {"pixel": {...}} с полем url: код пикселя, который нужно вставить в рекламные материалы (баннеры), после чего на его основе можно... |
| update_pixel | Изменяет указанный пиксель (в схеме изменения доступно только поле name — переименование). Ответ — {"pixel": {...}} с обновлёнными данными. |
| delete_pixel | Удаляет указанный пиксель Яндекс Аудиторий. Успешный ответ — {"success": true}. В API существует метод восстановления удалённого пикселя (POST /v1/management/pixel/{id}/undelete) — при необходимости... |
| list_segment_grants | Возвращает список разрешений на управление сегментом. Ответ — {"grants": [...]}: у каждого разрешения user_login (логин пользователя), permission (edit — редактирование, view — просмотр), comment и... |
| add_segment_grant | Создаёт разрешение на управление сегментом для указанного логина Яндекса. permission: edit — редактирование и использование сегмента, view — только просмотр/использование. |
| delete_segment_grant | Удаляет разрешение на управление сегментом у указанного пользователя. Успешный ответ — {"success": true}. |
| raw_request | Escape hatch: прямой вызов любого пути Yandex Audience API, для эндпоинтов без выделенного инструмента (например, PUT "v1/management/segment/{id}/reprocess" — пересчёт сегмента, или POST... |
Signals
- Last commit
- Aug 2026
- Weekly downloads
- 181
- Tools captured
- 20