@retensy/mcp 0.53.0 → 0.54.0

package/README.md

@@ -306,6 +306,12 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 | `audience_fields(botId, search?, limit?)` | ключи переменных (с выведенным типом) и теги бота — для построителя фильтра |
 | `audience_search(botId?, botIds?, filter?, q?, sort?, dir?, page?, size?)` | фильтр+сортировка подписчиков: один бот или кросс-бот (без `botId`); `filter` — полный `AudienceFilter` (теги any/all/none, диапазоны дат, `blocked`, `variableConditions`) |
 | `audience_tag_edit(botId, chatIds, add?, remove?)` / `audience_variable_edit(botId, chatIds, set?, unset?)` | массово добавить/снять теги / установить/снять переменные у выбранных подписчиков |
+| `subscribers_overview(days?)` | **из каталога сервера.** Подписчики по ВСЕМ ботам за один вызов: новые, активные, всего, заблокировали, итого и топ ботов. Считает сервер, ботов по одному запрашивать не нужно |
+| `leads_overview(siteIds?, days?)` | **из каталога сервера.** Точная сводка заявок по всем сайтам: счётчики по статусам, сайтам и `utm_source`, пять новых заявок. Без листания страниц |
+| `bookings_overview()` | **из каталога сервера.** Записи по всем календарям: сколько ждут подтверждения и сколько предстоящих |
+| `leads_bulk_status(toStatus, fromStatuses?, siteIds?, utmSource?, days?)` | **из каталога сервера.** Массово сменить статус заявок по условию, до 500 за раз, id не нужны. Только свои сайты. Нужен `confirmToken`: сервер возвращает сводку «что и сколько», повтор с токеном выполняет (токен действует, пока число подходящих заявок не изменилось). Право `write:sites` |
+| `bookings_bulk_decide(action, calendarIds?, bookingIds?, from?, to?)` | **из каталога сервера.** Массово подтвердить (`CONFIRM`), отклонить (`REJECT`) ждущие записи или отменить активные (`CANCEL`, только с `from`+`to` или `bookingIds`), до 100 за раз. Клиентам уходят уведомления как при одиночном действии. Нужен `confirmToken`. Право `crm` |
+| `audience_bulk_tag(add?, remove?, botIds?, filter?, q?)` | **из каталога сервера.** Поставить/снять теги всем подписчикам, подходящим под условие (`filter` как в `audience_search`), без chatId, до 5000 за раз. Нужен `confirmToken`. Право `crm` |
 | `audience_export(botId?, botIds?, filter?, q?, format, savePath?)` | потоковая выгрузка ТЕКУЩЕЙ отфильтрованной выборки, `csv`\|`xlsx` (xlsx требует `savePath` — бинарный формат), потолок 100000 строк |
 | `dialog_search(q, limit?)` | кросс-бот поиск по «Диалогам» — имя/username/id/текст сообщения |
 | `publications_usage(botId)` | месячная квота публикаций владельца (общая для Telegram/MAX/Instagram/VK) |
@@ -352,6 +358,26 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 | `catalog_category_list()` | категории магазина: `id`, `name`, `parentId` |
 | `catalog_category_upsert(name, id?, parentId?, confirm:true)` | создать (без `id`) или переименовать (с `id`) категорию; без `parentId` при обновлении родитель сохраняется |
 
+### Промокоды, возвраты и настройки кабинета (из каталога сервера)
+
+Эти инструменты приходят из каталога сервера (`GET /api/agent-tools/catalog`) и появляются без обновления пакета. Все изменяющие требуют `confirm:true` и `confirmToken` (сервер сначала возвращает сводку «что будет сделано»).
+
+| Tool | Назначение |
+|---|---|
+| `promo_list()` / `promo_create(code, kind, value, maxUses?, expiresAt?, minOrder?)` / `promo_toggle(promoId, active)` / `promo_delete(promoId)` | промокоды заказов магазина: `kind` = `percent`\|`fixed`, лимит применений, срок, минимальная сумма; скидка считается от суммы товаров, действует на сайте и в боте |
+| `order_refunds(orderId)` / `order_refund(orderId, requestId, amount?, reason?)` | возвраты денег по заказу через ЮKassa: без `amount` вернуть остаток целиком, с `amount` — часть. `requestId` — ключ операции (16–100 символов), повтор с тем же ключом не вернёт деньги второй раз. Нужно право `billing` |
+| `order_refund_retry(orderId, refundId)` / `order_refund_manual(orderId, refundId)` / `order_refund_abandon(orderId, refundId)` | повторить непрошедший возврат (при неизвестном исходе — с тем же ключом), отметить «вернул вручную в кабинете ЮKassa», отказаться от точно непрошедшего возврата |
+| `operator_duty_get(botId)` / `operator_duty_set(botId, enabled, workFrom?, workTo?, workDays?, timezone?, offlineReply?, slaMinutes?)` | рабочее время оператора, автоответ вне часов, SLA-предупреждение владельцу; настройка заменяется целиком |
+| `payment_reminder_get(botId)` / `payment_reminder_set(botId, enabled, afterMinutes?, text?)` / `payment_reminder_stats(botId)` | напоминание тем, кто начал оплату и не закончил, и результат |
+| `tg_business_status(botId)` | подключён ли бот к Telegram Business и какие аккаунты (подключение — в приложении Telegram) |
+| `managed_bot_config()` / `managed_bot_start(name?)` / `managed_bot_status(managedId)` | создание бота через Managed Bots без ручного токена |
+| `consents_history(botId, chatId)` / `consent_revoke(botId, chatId, documentKey?)` / `consents_export(botId, chatId?)` | согласия клиентов (152-ФЗ): журнал, отзыв, выгрузка CSV (персональные данные, право `destructive`) |
+| `linked_chats_list(botId)` | каналы и группы, где бот администратор (публикация — `channel_post`) |
+| `graph_validate(graphId)` | проверить сценарий без публикации: ошибки и предупреждения |
+| `kb_search(kbId, q)` / `kb_doc_history(kbId, docId)` | поиск по базе знаний и история пересборок документа |
+| `agent_checklist(agentId)` / `agent_checks_latest(agentId)` / `agent_analytics(agentId, days?)` / `agent_insights(agentId)` | чек-лист, последняя проверка, аналитика (7/30/90 дней) и рекомендации ИИ-агента |
+| `attention_get()` | счётчики «требует внимания»: заявки, диалоги без ответа, интеграции, боты на паузе |
+
 ### Рассылки
 
 Сообщение рассылки — как в мастере кабинета: `{type, text?, mediaUrl?, mediaUrls?, buttons?}`, до 5 сообщений.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "MCP server to build and publish Telegram and MAX bot funnels/automations, broadcasts, service integrations, block-based websites (incl. free-layout Zero blocks, designs, templates, custom domains, form leads) and Markdown blog articles in the Retensy Bots service. Zero dependencies.",
   "type": "module",
   "bin": {