Skip to main content
Glama
@retensy/mcp
by retensy

retensy-mcp

CI npm version node license: MIT

MCP-сервер (+ скилл для Claude Code) для сборки и публикации воронок/автоматизаций ботов (Telegram, MAX и Instagram) в сервисе retensy /bots: из текстового описания → валидный граф сценария → заливка и публикация через API.


Быстрый старт

  1. Получи токен. Залогинься на https://bots.retensy.com → открой /bots/mcp-tokens → создай токен → скопируй секрет zmcp_... (показывается один раз).

  2. Подключи у своего клиента (env-переменные везде одни и те же: RETENSY_BASE_URL, RETENSY_MCP_TOKEN):

    Claude Desktop — добавь в claude_desktop_config.json:

    {
      "mcpServers": {
        "retensy-mcp": {
          "command": "npx",
          "args": ["-y", "@retensy/mcp@latest"],
          "env": {
            "RETENSY_BASE_URL": "https://bots.retensy.com",
            "RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
          }
        }
      }
    }

    Claude Code — одной командой:

    claude mcp add retensy-mcp -e RETENSY_BASE_URL=https://bots.retensy.com -e RETENSY_MCP_TOKEN=zmcp_ваш_токен -- npx -y @retensy/mcp@latest

    Или как плагин (подтянет и скиллы, см. «Вариант A» ниже):

    /plugin marketplace add retensy/retensy-mcp
    /plugin install retensy-mcp@retensy

    Cursor — Settings → MCP → Add new MCP Server (или .cursor/mcp.json в проекте) — тот же JSON-объект, что и для Claude Desktop выше (mcpServers.retensy-mcp с command/args/env).

  3. Собери первую воронку. Опиши сценарий словами агенту — он сам соберёт граф и опубликует (см. «Использование»), либо перенеси готовую воронку из другого сервиса — см. «Перенос воронки из другого конструктора» ниже.

Проверить подключение в любом клиенте: спроси агента «настрой подключение» — вызовет setup и подскажет, если что-то не так.


  • 🤖 Сценарии ботов: list_bots, list_graphs, list_channels, get_graph, create_graph, update_graph, edit_graph_live, patch_graph, dry_run, publish_graph, unpublish_graph, import_funnel, list_templates, create_graph_from_template, clone_graph, copy_graph, rename_graph, set_active_graph, delete_graph, upload_file, list_files, delete_file, graph_analytics, list_bot_users, list_links (+ setup/set_token).

  • 🔌 Боты и сервисы: create_bot (Telegram/MAX по токену), bot_stop/bot_resume, connect_integration/disconnect_integration (amoCRM, Битрикс24, GetCourse, Я.Метрика, ЮKassa; Google Таблицы — ссылкой на вход Google; креды хранятся зашифрованными и не возвращаются), integration_catalog/integration_status/integration_test (каталог Integration Core и живая проверка подключения), integration_ingress_url (URL ингресса «Внешних событий» — Tilda, JivoSite, WooCommerce, amoCRM, Битрикс24, GetCourse, CloudPayments, Robokassa, Т-Банк, Prodamus — для TRIGGER_WEBHOOK), channel_post (пост в канал Telegram/MAX).

  • 📣 Рассылки: broadcast_preview (оценка охвата до отправки), broadcast_send (сейчас или по расписанию, сразу по нескольким ботам; сообщения или запуск сценария; полный фильтр аудитории audienceFilter или сохранённый сегмент segmentId, дедуп dedup, распределённый запуск stagger по ботам, localTime - в HH:mm по часам каждого подписчика), broadcast_test (тест себе), audience_segments (сохранённые сегменты), bot_delivery_window (тихие часы бота), broadcast_list/broadcast_get/broadcast_cancel, повторяющиеся (broadcast_recurring), черновики (broadcast_drafts, broadcast_duplicate), мульти-бот группы (broadcast_group — preview/list/get/pause/resume/cancel) + скилл send-broadcast.

  • 👥 Аудитория подписчиков: audience_search/audience_fields — кросс-бот поиск и фильтр (теги, даты, статус, условия по переменным), audience_tag_edit/audience_variable_edit — массовое редактирование тегов/переменных, audience_export — потоковая выгрузка выборки в CSV/XLSX, dialog_search — поиск по «Диалогам» (включая текст сообщений).

  • 📤 Миграция подписчиков из других конструкторов: migration_presets/migration_preview/migration_commit — generic CSV column-mapper для BotHelp/SaleBot/Senler/Leadteh/Smartsender/ManyChat (переносятся только подписчики — ни один из них не публикует документированный формат экспорта воронки).

  • 📅 Запись на слоты: booking_calendar_* (буферы до/после брони, горизонт записи, типы встреч своей длительности, форма клиента, публичная страница /book/<slug>), booking_confirm/booking_reject — ручное подтверждение брони (confirmationMode:"MANUAL").

  • 📰 Публикации и VK: publications_usage — месячная квота (общая для Telegram/MAX/Instagram/VK), vk_status/vk_connect/vk_disconnect/vk_post — подключение VK-сообщества токеном и публикация на стену.

  • 🔗 Ссылка вместо отказа: что нельзя сделать через API (вход через Google/Instagram, оплата тарифа, вход в аккаунт) — инструмент возвращает прямую ссылку и одну строку, что сделать.

  • 📝 Статьи блога (тот же токен zmcp_…): article_publish, article_update, article_list, article_get — публикация статей в Markdown (как README на GitHub) в раздел /articles.

  • 🧠 ИИ-агенты и база знаний: agent_list/agent_get/agent_create/agent_update/agent_publish/agent_health/agent_test_chat/agent_unanswered/agent_tests_run/agent_tests_list, agent_tool_calls, kb_docs/kb_add_qa/kb_add_text/kb_add_site/kb_reindex — настройка ИИ-агента и его базы знаний (раздел «ИИ-агенты»).

  • 📎 Медиа: upload_file грузит фото/видео/документы в библиотеку /bots/files (до 50 МБ) и возвращает публичный URL — его вставляешь в медиа-карточку сценария.

  • 🌐 Сайты из блоков (раздел «Страницы»): создание, правка операциями (блоки, Zero-блок со свободной вёрсткой, код блока, папки страниц, дизайны, шаблоны из библиотеки), публикация и откат, свои домены, заявки из форм и куда их доставлять — инструменты site_* + скилл build-site.

  • 🧠 Скилл build-bot-funnel: учит агента собирать корректный граф (типы узлов, ветки, кнопки, задержки) и проверять его перед публикацией. Поддерживает Telegram, MAX и Instagram.

  • 🔁 Скилл rebuild-funnel-from-builder: переносит воронку из другого конструктора (BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot и др.) по export JSON/тексту, скриншотам или пересказу — в граф Retensy, новым черновиком, без перезаписи текущего сценария. См. «Перенос воронки из другого конструктора».

  • 🔗 Скилл build-publication-chain: учит агента собирать «Цепочки публикаций» (автопостинг source → граф обработки → N назначений) — линейно или графом (общий/раздельный ИИ-адаптер на ветках), UTM по назначению, согласование, фан-аут в один заход («1 источник → общий ИИ → 10 TG-каналов + 2 VK + 4 MAX»).

  • 📦 Без зависимостей — чистый Node ≥18, ставится и запускается сразу.

Поддерживаемые платформы

Платформа

Онбординг

Триггеры входа

Ограничения

Telegram

Токен бота (BotFather) → create_bot

/start, команды, callback, текст, рассылки, Telegram Business (бот отвечает от имени аккаунта владельца: business_message, условие BUSINESS)

Полный функционал

MAX

Токен бота (MasterBot в MAX) → create_bot

Команды, callback, текст

Без SUBSCRIBED/reply-клавиатур (мягкие предупреждения)

Instagram

Вход через Instagram (OAuth) в кабинете /bots/instagram (без токена) — нужен Instagram-аккаунт Business или Creator

Комментарий/Direct/Ответ на историю/Упоминание

Ограниченный набор узлов; DELAY ≤ 24ч; ASK_QUESTION только TEXT/EMAIL/PHONE/NUMBER/CONTACT (CONTACT = ручной ввод номера); без рассылок


Related MCP server: Telegram MCP Server

Установка

Вариант A — как плагин Claude Code (рекомендуется)

/plugin marketplace add retensy/retensy-mcp
/plugin install retensy-mcp@retensy

Подтянутся MCP-сервер и скиллы build-bot-funnel, rebuild-funnel-from-builder, build-site, send-broadcast, build-publication-chain. Проверить: /mcp и /plugin.

Вариант B — как обычный MCP-сервер (Claude Code / Cursor / Windsurf / любой MCP-клиент)

Через npx без установки. Пример конфига (.mcp.json / настройки клиента):

{
  "mcpServers": {
    "retensy-mcp": {
      "command": "npx",
      "args": ["-y", "@retensy/mcp@latest"],
      "env": {
        "RETENSY_BASE_URL": "https://bots.retensy.com",
        "RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
      }
    }
  }
}

См. также examples/.mcp.json.


Авторизация — персональный токен

Токен действует от твоего имени в пределах выбранных прав (см. «Права токена» ниже).

  1. Залогинься на https://bots.retensy.com → открой /bots/mcp-tokens.

  2. Выбери права токена (пресет «Только чтение», «Полный доступ» или свой набор) и, при желании, срок действия → создай токен → скопируй секрет zmcp_... (показывается один раз).

  3. Передай токен любым способом:

    • просто пришли его агенту в чат — он вызовет инструмент set_token и сохранит токен в ~/.retensy-bot-graph/token (применяется сразу, без рестарта), или

    • env в .mcp.json (Вариант B), или

    • переменной окружения: PowerShell setx RETENSY_MCP_TOKEN "zmcp_...", bash export RETENSY_MCP_TOKEN="zmcp_...".

Отозвать токен можно там же — доступ блокируется мгновенно.

С 14.10 тот же токен zmcp_... полностью покрывает и вебхук-сценарии (/api/scenarios — scenario_*), и управление подключениями сервисов (/api/integrations — connect_integration/disconnect_integration/ integration_update и остальные integration_*), не только /api/bots. Отдельного токена под эти инструменты не нужно.

Права токена (scopes)

С 17.10.2026 у токена есть права. Их проверяет сервер на каждом запросе, а не MCP-клиент, поэтому прямой вызов API (curl и т.п.) их тоже не обходит; MCP-клиент только объясняет отказ. Но права крупные — выдавай токену только то, что нужно для задачи.

Право

Что разрешает

Примеры инструментов

read

любое чтение: списки, карточки, аналитика, превью, поиск, dry_run. Включает персональные данные: подписчики, переписка в диалогах, заявки с сайтов и их файлы

list_bots, get_graph, site_leads, dialog_messages, broadcast_preview

write:bots

создание и изменение ботов, сценариев, цепочек, интеграций, ИИ-агентов, базы знаний, черновиков рассылок. Правка опубликованного сценария сразу меняет ответы бота подписчикам; можно сменить ключи и вебхуки интеграций; agent_test_chat и agent_tests_run тратят ИИ-бюджет, integration_test ходит во внешний сервис

create_graph, publish_graph, chain_update, connect_integration, agent_test_chat

write:sites

сайты, лиды, VK-лендинги, статьи

site_create, site_edit, site_publish, vk_landing_update, article_publish

crm

теги/переменные подписчиков, импорт, передача диалога оператору, записи. booking_confirm/booking_reject отправляют клиенту сообщение

audience_tag_edit, bot_users_import, dialog_handoff, booking_create

broadcast

всё, что доходит до живых людей без участия человека: рассылки, ответы, посты, а также включённая цепочка без согласования постов (approvalMode NONE/AI_ONLY) и публикация/правка/активация сценария с TRIGGER_SCHEDULE

broadcast_send, dialog_reply, channel_post, vk_post, chain_approve, chain_enable (без согласования)

billing

деньги и ключи, которые тратят бюджет

ai_pack_purchase, agent_api_key_create

destructive

любое удаление и массовая выгрузка ПДн

delete_graph, bot_delete, audience_export, site_leads_export

  • Пресеты: «Только чтение» = read; «Полный доступ» = все семь. По умолчанию в кабинете предлагается read + write:bots + write:sites — собирать ботов и сайты. Это не «безопасный» набор: он видит ПДн подписчиков и заявок и меняет живые ответы ботов и ключи интеграций. В нём нет только рассылок, оплаты, удаления и выгрузки.

  • Цепочки и расписание с одним write:bots: цепочку можно создать выключенной или с согласованием каждого поста (approvalMode: ALL), сценарий по расписанию, с отправкой в заданный чат/канал (target.mode chat/expression) или вебхук-сценарий с получателем из тела запроса (recipientFrom) — оставить черновиком. Включить/опубликовать — нужен broadcast. То же для сценария с письмом на любой адрес, кроме ровно {{var.email}} подписчика (и если сценарий сам не перезаписывает email), и для сценария с триггером события Telegram/комментария и шагами отправки — там «ответ в текущий чат» уходит в канал или группу. Правка живого вебхук-сценария и новый секрет живого вебхука, который шлёт людям, тоже требуют broadcast.

  • Нет права → сервер отвечает 403 {"error":"insufficient_scope","requiredScope":"…"}, а инструмент возвращает ошибку «Токену не хватает права «X» …». Это не сбой: добавь право токену кнопкой «Изменить права» на /bots/mcp-tokens (действует со следующего запроса, переподключать клиента не нужно) или выпусти новый токен.

  • Старые токены (выпущены до появления прав) работают как раньше — с полным доступом; в кабинете они помечены «полный доступ (старый токен)». Рекомендуем ограничить им права.

  • Срок действия (30/90/365 дней или бессрочно) задаётся при создании; истёкший токен отвечает 401 и не ротируется (400 token_expired) — выпусти новый. Ротация сохраняет права и длительность срока; API ротации принимает и новые права (scopes/preset) — так старый токен переводят на явные права.

Не знаешь, что делать? Скажи агенту «настрой подключение» — он вызовет setup, объяснит шаги и попросит токен. Любой инструмент при отсутствии токена тоже вернёт пошаговую инструкцию.

Дев-окружение: RETENSY_BASE_URL=http://localhost:8066. Fallback без токена: RETENSY_SESSION_COOKIE = значение куки SESSION из браузера.


Использование

Опиши воронку словами — агент соберёт граф и (через MCP) опубликует:

«Собери бота: /start → приветствие с кнопкой подписки на канал → вопрос с 3 кнопками (бизнес / эксперт / просто смотрю) → для каждой свою цепочку из 2 сообщений с задержкой 1 день → финал с регистрацией на вебинар. Залей в бота и опубликуй.»

Под капотом скилл соберёт nodes/edges, прогонит локальную проверку и вызовет import_funnel → создаст граф, зальёт узлы, прогонит dry-run /start, опубликует. При ошибках публикации — разберёт по code/nodeId, починит, повторит.

Инструменты

Tool

Назначение

setup

статус авторизации + пошаговая инструкция подключения

set_token

сохранить присланный токен zmcp_… (без env/рестарта)

account_add(name, token) / account_list / account_remove(name)

несколько аккаунтов: токены хранятся под именами в ~/.retensy-bot-graph/accounts.json; аргумент retensyAccount: "<имя>" в любом инструменте выполняет этот вызов под нужным аккаунтом, не меняя аккаунт по умолчанию

list_bots

список ботов (pausedReason: TOKEN_CONFLICT / pausedChannels — бот или канал на паузе из-за вебхука другого сервиса на том же токене; conflictWarning: TOKEN_CONFLICT_POLLING — токен опрашивает кто-то ещё, бот работает, но теряет сообщения)

create_bot(platform, token?, name?)

подключить бота Telegram/MAX по токену; WEB — чат-виджет для сайта без токена → botId, key, snippet (Instagram → ссылка на кабинет /bots/instagram, вход через Instagram)

web_widget_snippet(botId)

код вставки чат-виджета на сайт

bot_stop(botId) / bot_resume(botId)

остановить / запустить бота

list_graphs(botId)

графы (сценарии) бота

list_channels(botId)

каналы/группы, подключённые к боту (chatId для условия SUBSCRIBED)

list_integrations()

подключённые сервисы (amoCRM, Битрикс24, GetCourse, Я.Метрика, ЮKassa): id = connectionId для действий сценария

connect_integration(provider, creds?, title?, connectionId?)

подключить/обновить сервис; без кредов — какие поля нужны; Google Таблицы → ссылка входа Google, Instagram → ссылка на кабинет /bots/instagram (вход через Instagram)

disconnect_integration(connectionId)

удалить подключение

integration_catalog()

каталог Integration Core: поля подключения (configSchema) и действия (actions[].kind) сервисов

integration_status(connectionId)

статус подключения: OK / NEEDS_REAUTH / ERROR / UNKNOWN, последняя проверка и ошибка

integration_test(connectionId)

живая проверка ключа во внешнем сервисе от имени владельца (без побочных эффектов)

integration_ingress_url(connectionId, rotate?)

URL ингресса для триггера «Внешние события» (TRIGGER_WEBHOOK с provider+connectionId+event); rotate:true — выпустить новый, старый отключается сразу

channel_post(botId, chatId, text?, mediaUrl?)

разовый пост в канал/группу Telegram или MAX (раздел «Публикации»); файл — из upload_file

get_graph(graphId, [summary], [saveToFile])

получить граф; summary:true — компактная сводка (id/type/title + рёбра), saveToFile — записать полный JSON на диск (для больших графов, чтобы не упереться в лимит токенов)

create_graph(botId, name)

создать пустой граф (DRAFT)

update_graph(graphId, graphFile|graph|nodes,edges)

залить узлы/рёбра (PUT); graphFile — путь к локальному JSON, граф не нужно слать инлайном

edit_graph_live(graphId, graphFile|graph|nodes,edges)

правка живого графа НА МЕСТЕ + авто-бэкап (рекомендуется для прода)

patch_graph(graphId, replacements)

строковые замены в JSON графа на сервере (для больших/живых графов)

dry_run(graphId, kind, value)

прогон без публикации

publish_graph(graphId, secondary?)

публикация (вернёт errors[] при провале); secondary: true — дополнительный сценарий рядом с основным (запускают VK-лендинги и ссылки с targetGraphId)

unpublish_graph(graphId)

снять дополнительный сценарий с публикации (основной — 409)

graph_versions_list(graphId, [version], [compareTo])

история версий сценария (снимки при публикации, правках живого графа, ручные); с version:N — сравнение с текущим графом или другой версией (compareTo). Право read

graph_version_rollback(graphId, version)

откат сценария на версию = публикация снимка (проверки как у edit_graph_live, текущее состояние сохраняется отдельной версией). Право write:bots

import_funnel(botId, name, graphFile|graph)

всё за раз: create → update → dry-run → publish

list_templates([niche], [channel], [query])

готовые шаблоны воронок (~30, ниша и каналы в карточке; фильтры по нише, каналу, тексту); те же открыты публично на /templates

create_graph_from_template(botId, templateId, name)

граф из шаблона (DRAFT)

clone_graph(graphId)

копия графа в новый DRAFT

rename_graph(graphId, name)

переименовать сценарий

set_active_graph(botId, graphId)

переключить активный (живой) граф бота

delete_graph(graphId)

удалить граф (активный — нельзя, 409)

upload_file(path|url)

загрузить файл в /bots/files → публичный url для медиа-карточки

list_files()

файлы библиотеки /bots/files + использовано/лимит байт

delete_file(id)

удалить файл из /bots/files

graph_analytics(graphId)

прохождение сценария по узлам (где отваливается воронка)

list_bot_users(botId)

подписчики/лиды бота (постранично, поиск query)

list_links(botId)

стартовые трекинговые ссылки бота с UTM

site_list()

сайты пользователя (id, mode, url, publishedRevision, status — BLOCKED у заблокированных модерацией, blockedReason)

site_create(title, slug?, template?)

новый сайт из блоков → id; template (starter/blank/mini-landing/shop-starter) — сразу черновик из шаблона; число сайтов ограничено тарифом — сверх лимита HTTP 402 с причиной и ссылкой на смену тарифа

site_get(siteId, saveToFile?)

модель сайта (revision, draft, versions[] публикаций)

site_schema(full?)

компактный справочник модели и операций (~10 КБ); full:true — полная JSON Schema — читать перед правкой

site_edit(siteId, ops[]?, revision?, init?, reset?)

правка операциями (init: starter/blank/mini-landing/shop-starter; только init — черновик из шаблона; reset:true с init и revision — пересобрать черновик из шаблона, деструктивно), всё или ничего: страницы и папки, блоки, Zero-элементы, код блока (get/set/add_block_code), дизайны и их кадры, шаблоны (add_template), тема, попапы; пиксели аналитики (GA4/GTM/Meta/VK/Яндекс.Метрика) — тоже сюда, set_settings {analytics: {...}} (отдельного инструмента нет — те же settings.analytics модели сайта, валидируются форматом id на сервере)

site_templates(category?, full?)

библиотека шаблонов блоков для add_template

site_publish(siteId)

опубликовать черновик → url

site_rollback(siteId, revision)

вернуть прошлую публикацию

site_upload_asset(siteId, path|url)

картинка/видео в сайт → assets/…

site_domains(siteId, action, host?, withWww?, domainId?)

свои домены: list / add / check / remove (число — по тарифу)

site_leads(siteId, page?, size?)

заявки из форм (поля, UTM, статус доставки)

site_lead_settings(siteId, settings?)

куда доставлять заявки: бот уведомлений, почта, вебхук, вебхук-сценарий, amoCRM, «Интеграция» (coreDelivery {connectionId, kind, params} из coreConnections)

broadcast_list(botId?, group?, page?, size?)

рассылки + счётчики разделов (черновики/запланированные/отправленные/повторы)

broadcast_get(broadcastId)

рассылка целиком: статус, счётчики, сообщения, причины ошибок

broadcast_preview(botIds, tagsAll?, tagsNone?, audienceFilter?, segmentId?)

оценка охвата: сколько подписчиков получат рассылку; blockedExcluded - сколько заблокировали бота и в охват не входят

broadcast_send(name, botIds, messages | graphId, tagsAll?/tagsNone? или audienceFilter?, scheduledAt?, draftId?, segmentId?, localTime?, dedup?, stagger?)

отправить сейчас / запланировать; по нескольким ботам; или запуск сценария; dedup/stagger → мульти-бот группа (broadcast_group) вместо прямых рассылок; scheduledAt задаёт старт и группы. Без confirmToken: первый корректный вызов сразу создаёт рассылку, поэтому до вызова покажи человеку получателей, текст и время старта из broadcast_group preview и получи явное согласие

audience_segments(action, botId, …)

сохранённые сегменты аудитории: list / create {name, audienceFilter} / delete {segmentId}; дальше segmentId в broadcast_send/broadcast_preview

bot_access(botId, action, …)

закрытый бот и список доступа: get / settings {privateBot, deniedMessage} / add {items[{kind TG_ID|USERNAME|PHONE, value, note?}] или text} / remove {entryId} / clear {confirm:true}; проверка в сценарии - узел ACCESS_GATE

preset_list(botId?) / preset_save(name, nodeType, config, presetId?, botId?) / preset_delete(presetId)

пресеты блоков (аккаунт или бот). Секретные заголовки хранятся зашифрованно и приходят ссылками preset-secret:<id>:<Header> - их подставляют в headersJson узла, открытым текстом секреты не выводятся

webhook_requests(graphId, action?)

входящие запросы сценария-вебхука (последние 50 за 7 дней, секреты скрыты): list / listen (тестовый URL /api/webhooks/t/<path>) / stop / clear {confirm:true}; для TRIGGER_WEBHOOK mappings

http_test(url, method?, headersJson?, bodyTemplate?, timeoutMs?, vars?)

тестовый запрос с сервера (SSRF-защита, 15 с, 1 МБ): status, headers, body и fields (JsonPath) для extract:[{path,saveTo}]

bot_delivery_window(action, botId, …)

тихие часы бота (по умолчанию выкл): get / set {enabled, quietFrom, quietTo, timezone?}; рассылки в окне переносятся на его конец, пояс - подписчика (переменная timezone), иначе бота

broadcast_test(botId, messages, chatId?)

тест рассылки себе: на привязанный Telegram владельца или в чат подписчика; мимо квоты и очереди

broadcast_cancel(broadcastId)

отменить запланированную/идущую (для группы — broadcast_group action:"cancel")

broadcast_recurring(action, …)

повторяющиеся рассылки: list / create (DAILY·MONTHLY·YEARLY, те же audienceFilter/dedup/stagger) / stop

broadcast_drafts(action, …)

черновики: list / get / create / update / delete

broadcast_duplicate(broadcastId или draftId)

копия рассылки или черновика — новый черновик «… (копия)»

broadcast_group(action, …)

мульти-бот группа с дедупом/распределённым запуском: preview (read-only оценка) / list / get / pause / resume / cancel (каскадом на уже запущенные боты)

article_list()

свои статьи блога (id, slug, title, просмотры)

article_get(slug)

статья по slug (Markdown content, excerpt, обложка)

article_publish(content, title?, cover?, excerpt?)

новая статья (Markdown; title из # ..., если не задан; обложка из cover-URL или 1-й картинки → OG; excerpt явно или авто) → id, slug, URL

article_update(id, content, title?)

обновить свою статью по id

agent_list()

список ИИ-агентов (id, имя, статус)

agent_get(agentId)

настройки агента: язык, тон, длина/формат ответа, инструкции, темы, kbId базы знаний, статус

agent_create(name?, description?)

создать агента; вместе с ним создаётся база знаний (kbId в ответе)

agent_update(agentId, patch)

частично изменить настройки (patch — только меняемые поля: tone, language, instructions и т.п.)

agent_publish(agentId)

опубликовать; 409 CHECKLIST_FAILED, если агент не готов

agent_health(agentId)

счётчики документов/фрагментов базы знаний

agent_test_chat(agentId, question, history?)

проверить ответ в песочнице (тратит бюджет ИИ — не вызывай массово)

agent_unanswered(agentId, days?)

вопросы без ответа за период (7|30|90, по умолчанию 30)

analytics_ask(question)

вопрос к аналитике по-русски: бэкенд переводит его в вызов белого списка запросов по данным владельца, ответ с числом, таблицей и «как посчитано»; тратит квоту ИИ

faq_suggestions(agentId, action, suggestionId?, question?, answer?)

авто-FAQ: list / generate / approve (в базу знаний как QA) / dismiss

agent_tests_run(agentId, confirm, caseIds?, generate?, wait?, timeoutSec?)

проверка агента ИИ-клиентами по тест-кейсам: диалог в песочнице, ИИ-судья (PASS/FAIL, причина, цитата), сравнение с прошлым прогоном. Тратит бюджет ИИ — нужен confirm:true

agent_tests_list(agentId, runId?)

тест-кейсы, история прогонов и полный прогон (последний или по runId) с регрессиями; ничего не тратит

kb_docs(kbId)

документы базы знаний агента (источник, статус, фрагменты)

kb_add_qa(kbId, pairs)

добавить пары вопрос-ответ (pairs: [{question, answer}], до 200 за раз)

kb_add_text(kbId, title, text)

добавить источник «Текст/инструкция»

kb_add_site(kbId, url, schedule?)

добавить сайт обходом страниц; schedule: NEVER|DAILY|WEEKLY|MONTHLY

kb_reindex(kbId, docId, headerRow?)

переиндексировать файл из оригинала («Повторить»); headerRow — для таблиц, если шапка определилась неверно

kb_list() / kb_create(name)

базы знаний: список / новая (база агента создаётся с ним — kbId в agent_get) (id → knowledgeBaseId узла AI_REPLY mode:"agent")

kb_delete_doc(kbId, docId)

удалить документ из базы знаний вместе с фрагментами

bot_user_get(botId, chatId)

карточка подписчика: теги, переменные, ai_summary

bot_user_runs(botId, chatId)

журнал запусков с шагами — проверка, что сценарий реально выполнил действия (CRM, уведомление, HTTP)

dialog_messages(botId, chatId) / dialog_reply(botId, chatId, text)

переписка с подписчиком / ответ оператора (уходит реальному человеку)

dialog_handoff(botId, chatId, active)

передать диалог оператору (бот и ИИ молчат) / вернуть боту

bot_users_import(botId, rows)

добавить/обновить подписчиков пачкой JSON (rows: [{chatId, tags?, variables?, subscribedAt?, source?, status?}]; существующие поля не перезаписываются, status: BLOCKED/UNSUBSCRIBED только выставляет блокировку, никогда не снимает)

bot_runs(botId или runId)

журнал прогонов бота / один прогон с шагами (статус PARTIAL — «завершён с ошибками»)

scenario_runs(graphId, page?, size?)

журнал прогонов одного сценария, включая headless (вебхук, заявки сайта, TRIGGER_SCHEDULE)

bot_delete(botId, confirm:true)

удалить бота навсегда (только по явной просьбе)

web_widget_settings(botId, settings?)

вид чат-виджета: прочитать / изменить (поля накладываются на текущие)

integration_update(connectionId, title?, creds?)

переименовать подключение или заменить ключи

integration_calls(connectionId?, ok?, limit?)

журнал вызовов внешних сервисов из сценариев (ошибки, попытки, runId)

site_lead_status(siteId, leadId, status)

статус заявки сайта: NEW|IN_PROGRESS|DONE|REJECTED (фильтр — site_leads(status))

bot_rename(botId, name) / bot_change_token(botId, token)

переименовать бота (пустое имя — @username) / сменить токен после перевыпуска

bot_channel_list(botId) / bot_channel_add(botId, token, name?) / bot_channel_delete(botId, channelId, confirm:true)

дополнительные Telegram-боты (мультиканальность); каналы/группы для постинга — list_channels

link_create(botId, name?, targetNodeId?) / link_delete(linkId, confirm:true)

стартовая ссылка (диплинк на узел) / удаление; список — list_links

utm_sources(botId) / ab_results(graphId, branchNodeId, period?)

UTM-источники подписчиков / итоги A/B-развилки (period: 24h, 7d, 30d)

source_revenue(botId, from, to)

Отчёт источник -> подписчики/покупатели/выручка (RUB + Stars)/конверсия, даты YYYY-MM-DD

bot_health(botId?)

Здоровье бота: статус OK/WARN/CRIT, проблемы с подсказками (токен, 409, опрос, ошибки сценариев, платежи, конверсия, ИИ-агент); без botId - все боты

funnel_report(days?)

Воронка владельцев и события шагов (админ платформы), только агрегаты

unsubscribe_reasons(botId, days?)

Причины отписки: блокировки, кнопки, темы свободных ответов (ИИ раз в неделю)

kb_delete(kbId, confirm:true)

удалить базу знаний целиком (база агента — только вместе с агентом)

agent_unpublish(agentId) / agent_delete(agentId, confirm:true)

снять агента с публикации / удалить (409 AGENT_IN_USE, пока подключён к сценариям)

site_leads_mark_read(siteId) / site_lead_delete(siteId, leadId, confirm:true) / site_leads_export(siteId, savePath?)

заявки сайта: всё прочитано / удалить заявку / CSV

bot_users_export(botId, format?, savePath?)

выгрузка подписчиков csv|json (с savePath — в файл)

bot_user_reset(botId, chatId, confirm:true)

сбросить сессию подписчика: позиция, метки, переменные (для повторного теста воронки)

booking_calendar_list() / booking_calendar_get(calendarId)

календари записи (id → calendarId действий сценария booking_*)

booking_calendar_create(name, zone?, slotMinutes?, hours?, exceptions?, botId?)

новый календарь: окна {day:1–7, from:"HH:mm", to:"HH:mm"}, исключения {date, from?, to?}

booking_calendar_update(calendarId, …поля) / booking_calendar_delete(calendarId, confirm:true)

правка (поля накладываются на текущие) / удаление

booking_slots(calendarId, from?, to?, limit?)

свободные слоты [{at, label}], даты ГГГГ-ММ-ДД в зоне календаря

booking_list(calendarId, from?, pendingOnly?) / booking_create(calendarId, slotAt, name?, phone?, email?, comment?, customAnswers?, meetingTypeId?) / booking_cancel(calendarId, bookingId)

брони: список (или только ждущие подтверждения) / ручная запись (занятый слот — ошибка «занят») / отмена

booking_confirm(calendarId, bookingId) / booking_reject(calendarId, bookingId)

подтвердить/отклонить бронь при confirmationMode:"MANUAL" (прочие поля календаря: breaks, meetingTypes, буферы, horizonDays, intakeFields, notifyOwner, slug+enabled — публичная ссылка /book/<slug> — в booking_calendar_create/_update)

event_list / event_get(eventId) / event_create(title, startsAt, ...) / event_update(eventId, ...) / ticket_type_upsert(eventId, name, price, limit, ...) / tickets_list(eventId, q?, status?) / ticket_checkin(eventId, ticketId) / ticket_cancel(eventId, ticketId, refund?)

билеты на события: события и типы билетов, участники, ручная отметка входа и отмена (последние два с подтверждением)

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)

vk_status() / vk_connect(communityId, accessToken) / vk_disconnect(accountId)

подключённые VK-сообщества / подключить токеном сообщества (проверяется живым вызовом VK) / отключить

vk_post(accountId, text?, mediaUrl?)

пост на стену VK (только текст/фото — без видео), списывает ту же квоту публикаций

migration_presets()

каталог источников миграции подписчиков (BotHelp/SaleBot/Senler/Leadteh/Smartsender/ManyChat/универсальный CSV)

migration_preview(botId, path, platform, mapping?)

пробный прогон CSV (ничего не пишет): без mapping — определение заголовков/подсказка сопоставления, с mapping — полный dry-run (новые/существующие, превышение лимита)

migration_commit(botId, path, platform, mapping)

реальный импорт подписчиков тем же mapping, что подтвердил migration_preview

zaytsv_migration_preview(bundleFile)

пробный прогон переноса ботов zaytsv.com в Retensy (только администратор), ничего не пишет: план по графам, подписчики новые/слитые, что не переносится

zaytsv_migration_commit(bundleFile)

реальный перенос тем же планом, идемпотентно; ботов не запускает и не останавливает

bothelp_scenario_preview(botId, scenarioFile, externalRequestsDir?)

dry-run структурной конвертации ОДНОГО сценария BotHelp (его собственный JSON-экспорт, не CSV) в граф Retensy — ничего не пишет, возвращает отчёт notes[] (что сконвертировано приближённо/заглушкой)

bothelp_scenario_commit(botId, scenarioFile, externalRequestsDir?)

то же + сохраняет граф (DRAFT); идемпотентно по (botId, bothelpScenarioId) — повторный вызов обновляет тот же граф

chain_list() / chain_get(chainId)

цепочки публикаций («Публикации» → «Цепочки», автопостинг source → граф обработки/назначений) / одна цепочка как хранится (legacy либо граф)

chain_graph_get(chainId)

граф цепочки ВСЕГДА graph-shaped {nodes, edges}, даже для старых линейных цепочек (синтезируется на лету)

chain_create(chain) / chain_update(chainId, chain)

создать / изменить цепочку целиком (chain: name, source TELEGRAM|VK|RSS, approvalMode?, utmDefaults?, и либо legacy destinations[]+steps[], либо граф nodes[]+edges[] — дерево с ветвлением, не произвольный DAG: один узел может кормить несколько назначений, слияния путей нет); граф-узлы — опциональные x?/y? (координаты холста, UI-подсказка, бэкенд не интерпретирует, опусти → авто-layout); каждое destination/destinations[] — опциональный aiOverride?: {enabled, aiMode, tone?, instructions?}, персональная адаптация ИИ сверх общего AI_ADAPT только для этого назначения; HTTP 409 — прямой цикл с другой цепочкой; графовый 400 — «Схема цепочки: …» (см. chain_validate)

instagram_status

включён ли Instagram, подключённые аккаунты, путь подключения (бета: только тестеры приложения); в IG уходят только посты с фото или видео

chain_create_draft(name, sourceBotId?, sourceChatId?, instagramAccountId?)

с тремя необязательными полями создаёт выключенную цепочку Telegram-канал -> Instagram; иначе:

chain_validate(nodes, edges) / chain_validate(chain)

офлайн-проверка графа (зеркало серверного ChainGraphValidator, не строже сервера) — перед chain_create/chain_update на сложном графе

chain_destinations_catalog(botIds?)

одним вызовом: все TG/MAX-каналы по ботам владельца + VK-аккаунты — собрать «1 источник → N каналов» без ручного обхода list_bots+list_channels+vk_status

chain_delete(chainId, confirm:true)

удалить цепочку (теряется история заданий)

chain_enable(chainId) / chain_pause(chainId)

включить / поставить на паузу приём новых постов источника

chain_runs(chainId, page?, size?)

история заданий цепочки, новые сверху (бэкенд без постраничной выдачи — page/size, если переданы, режут список в MCP)

chain_approve(jobId) / chain_reject(jobId)

согласовать / отклонить задание, ждущее подтверждения (approvalMode AI_ONLY/ALL)

chain_retry(jobId)

повторить проваленное задание вручную, минуя бэкофф

site_analytics(siteId, from?, to?)

KPI+тренд сайта: просмотры, клики (только с goalName), заявки, топ-страницы/источники (по умолчанию последние 30 дней)

site_analytics_events(siteId, from?, to?, page?, size?)

сырые события сайта постранично (PAGE_VIEW|CLICK|FORM_SUBMIT, UTM)

bot_subscriber_analytics(botId, from, to)

новые подписчики/активность бота по дням (дашборд аналитики, диапазон до 92 дней)

scenario_timeseries(graphId, from, to)

дневной ряд прогонов сценария {ok, failed, other} (по узлам — graph_analytics)

agent_tool_test(agentId, toolId, params?, live?)

проверить инструмент агента напрямую, без модели — бюджет ИИ не тратится. Чтение: AMO_LOOKUP/SHEETS_LOOKUP/HTTP_API. Запись (AMO_CREATE_LEAD, AMO_UPDATE_LEAD, AMO_UPDATE_CONTACT, SHEETS_APPEND, HTTP_POST, SET_FIELD, ADD_TAG, HANDOFF): по умолчанию песочница (ничего не уходит вовне), live:true отправляет по-настоящему

agent_tool_calls(agentId, toolId?, limit?)

журнал вызовов инструментов записи агента: кто/когда/аргументы без секретов/результат

site_lead_file_download(siteId, leadId, fileId)

метаданные вложения заявки + ссылка на скачивание (сам файл через MCP не передаётся — HEAD-запрос, не GET)

scenario_list()

сценарии автора, включая вебхук-сценарии (sourceType: WEBHOOK|BOT) — в list_graphs вебхук-сценарии не входят

scenario_create(name, botId?)

создать сценарий: без botId — вебхук-сценарий (сервер сам выпускает путь входа и секрет), с botId — бот-сценарий, сразу привязанный к боту

scenario_get(scenarioId)

сценарий целиком — граф + source (у вебхук-сценария: путь/секрет входа) + outputBinding

scenario_update_source(scenarioId, botId?, channel?, recipientFrom?)

привязка выхода вебхук-сценария, заменяется ЦЕЛИКОМ (без botId — привязка снимается, без recipientFrom — очищается); только для sourceType:"WEBHOOK"

scenario_publish(scenarioId)

опубликовать вебхук-сценарий (бот-сценарий — через publish_graph)

scenario_rotate_secret(scenarioId)

выпустить новый секрет входа вебхук-сценария — старый сразу перестаёт приниматься

agent_api_key_create(agentId, name?) / agent_api_key_list(agentId) / agent_api_key_revoke(agentId, keyId, confirm:true)

API-ключи публичного чата агента (zagt_..., секрет виден один раз) — для POST /api/public/agents/{agentId}/chat без основного токена

ai_packs()

каталог пакетов ответов ИИ сверх тарифа + текущий баланс (aiPackAnswersLeft)

ai_pack_purchase(sku, method?, confirm:true)

купить пакет — возвращает ссылку на оплату, деньги не списываются этим вызовом

Магазин (каталог)

Tool

Назначение

catalog_item_upsert(id?, sku?, name?, price?, images?, categoryIds?, categoryNames?, slug?, seoTitle?, seoDescription?, confirm:true)

создать/обновить товар по id или sku; slug — адрес страницы, seoTitle/seoDescription — свои заголовок и описание для поиска; images — до 10 https-ссылок на фото; categoryNames — находит категории по имени или создаёт их

catalog_category_list()

категории магазина: id, name, parentId

catalog_category_upsert(name, id?, parentId?, slug?, seoTitle?, seoDescription?, description?, confirm:true)

создать (без id) или переименовать (с id) категорию; без parentId при обновлении родитель сохраняется

catalog_list(q?, categoryId?, sort?, minPrice?, maxPrice?, inStock?, filters?, page?)

товары: поиск, сортировка (price_asc, price_desc, new, stock), цена, наличие и фильтр по характеристикам (`filters="color=red

shop_attributes_list() · shop_attributes_suggest()

характеристики магазина; сводка по каталогу, по которой ИИ предлагает набор фильтров под нишу (из каталога сервера)

shop_attributes_upsert(key, name, type, unit?, order?, filter?, categoryIds?, values?, aliases?) · shop_attribute_delete(key, purge?)

создать/изменить и удалить характеристику (list, number, bool, color); с подтверждением

catalog_attributes_fill(rules, categoryId?, overwrite?) · catalog_attributes_apply(...)

массовое заполнение характеристик у товаров: сначала предпросмотр с примерами, применение только после подтверждения

shop_seo_get() · shop_seo_set(productTitleTpl?, productDescTpl?, categoryTitleTpl?, categoryDescTpl?) · shop_seo_preview(itemId, ...) · catalog_item_page(id)

SEO-шаблоны витрины ({name} {category} {brand} {price} {sku} {shop} {count} {attr.<key>}), примерка на товаре, адрес и SEO страницы товара

transfer_list() · transfer_create(shop?, siteIds?, ttlHours?, note?, confirm:true) · transfer_cancel(transferId, confirm:true) · transfer_accept(code, confirm:true)

передача магазина (каталог, настройки, промокоды, заказы) и сайтов другому аккаунту по одноразовому коду; код, созданный через MCP, заработает после подтверждения владельцем в кабинете (/bots/transfer); ключи ЮKassa, 1С и токены не переносятся, их список в чек-листе reconnect

`catalog_bulk_preview(filter

ids, action, ...)·catalog_bulk(..., confirmDelete?)·catalog_export()·shop_template_get()·shop_template_reset(kind)`

Магазин B2B (заявки на расчёт, счета, группы, доставка)

Паритет с REST /api/bots/commerce/... и ИИ-инструментами кабинета (shop_*). Все изменяющие инструменты требуют confirm:true (после явного согласия пользователя). Ответ на заявку, смена статуса и отметка оплаты уведомляют покупателя и необратимы. Секреты не отдаются: у групп вместо joinCode приходит joinCodeSet, расчётный и корр. счёт продавца маскируются (****1234). Файлы (PDF счёта, вложение заявки, документ заказа) возвращаются base64 до 2 МБ либо сохраняются локально через savePath.

Tool

Назначение

shop_quotes_list(status?, page?, size?)

заявки на расчёт (quote_requested, quoted, paid, canceled)

shop_quote_answer(orderId, lines[{index,price}], deliveryCost?, note?, leadTime?, invoice?, company?, confirm:true)

ответить ценой на заявку (по номеру позиции с 0), при invoice:true сразу счёт

shop_order_status_set(orderId, status, confirm:true)

ручная смена статуса (new, paid, processing, assembled, shipped, delivered, returned, canceled); недопустимый переход - 409

shop_invoice_issue(orderId, company?, confirm:true) / shop_invoice_mark_paid(orderId, confirm:true)

выставить счёт (идемпотентно) / отметить оплату по счёту (нужно право токена billing)

shop_invoice_pdf(orderId, savePath?) / shop_quote_file_get(orderId, savePath?)

PDF счёта / вложение заявки: base64 или файл

shop_order_document_upload(orderId, filePath? или contentBase64+fileName, kind?, title?, confirm:true) / shop_order_document_get(orderId, docId, savePath?) / shop_order_document_delete(orderId, docId, confirm:true)

документы заказа (pdf/xlsx/docx/jpg/png до 5 МБ, до 20 на заказ)

shop_seller_get() / shop_seller_requisites_update(name?, inn?, kpp?, ogrn?, address?, bankName?, bik?, account?, corrAccount?, director?, phone?, email?, site?, vatMode?, accountant?, quotePaymentTerms?, quoteLeadTime?, confirm:true)

реквизиты продавца (патч) и признак ready для счёта; accountant - подпись бухгалтера, quotePaymentTerms - условия оплаты в КП, quoteLeadTime - срок готовности по умолчанию

shop_seller_checklist()

только чтение: чек-лист готовности реквизитов для счёта (ready, checklist[{key,label,done}])

shop_buyer_groups_get() / shop_buyer_group_upsert(code, name?, discountPct?, joinCode?, generateJoinCode?, clearJoinCode?, tag?, clearTag?, priceType?, priority?, confirm:true) / shop_buyer_group_delete(code, confirm:true) / shop_buyer_group_assign(chatId, groupCode?, confirm:true)

группы покупателей, назначения

shop_delivery_settings_get() / shop_delivery_settings_update(cutoffTime?, timezone?, workDays?, holidays?, weekendRule?, zones?, confirm:true)

доставка по зонам (zones - полный список)

shop_item_b2b_update(itemId, unit?, priceMode?, priceTiers?, groupPrices?, prices?, weightKg?, clearWeight?, oversize?, minQty?, qtyStep?, confirm:true)

B2B-поля товара: единица измерения (unit, до 12 символов), цена по заявке, ступени, цены групп, вес, крупногабарит

shop_b2b_settings_get() / shop_b2b_settings_update(priceTypes?, priceSelection?, quoteValidDays?, autoStatusOnPaid?, clearAutoStatus?, weekendRule?, minOrderSum?, invoiceReminderEnabled?, invoiceReminderDays?, confirm:true)

типы цен, срок КП, автостатус после оплаты; напоминание о неоплаченном счёте (invoiceReminderDays 1-30, по умолчанию 3)

shop_leads_list(type?, status?, page?, size?)

заявки магазина с сайта (SiteLead): quote / wholesale, статусы NEW/IN_PROGRESS/DONE/REJECTED

shop_lead_to_order(leadId, lines?, deliveryCost?, note?, leadTime?, confirm:true)

заявка на расчёт -> заказ quoted, покупателю уходит расчёт

shop_wholesale_approve(leadId, tag, confirm:true)

одобрить заявку на опт: тег группы покупателей контакту

shop_quote_pdf(orderId, savePath?)

PDF коммерческого предложения (base64 до 2 МБ или файл)

Список заказов и статус (order_list, order_status) по-прежнему из каталога сервера. Работает с backend, где выкачен контракт B2B (docs/shop/API_B2B.md).

Промокоды, возвраты и настройки кабинета (из каталога сервера)

Эти инструменты приходят из каталога сервера (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)

напоминание тем, кто начал оплату и не закончил, и результат

unmatched_reply_get(botId) / unmatched_reply_set(botId, enabled, mode?, agentId?, text?, handoff?) / unmatched_reply_stats(botId)

ответ бота на сообщения мимо сценария: готовый текст или ИИ-агент (с передачей человеку), итоги за 7 дней

graph_build_from_spec(botId, spec, graphId?)

произвольный сценарий из компактной спецификации (сообщения, вопросы text/number/phone/email/photo/file/choice, условия, кнопки-ссылки и переходы, метка и уведомление владельцу); только черновик, graphId дописывает ветку в существующий сценарий

graph_edit(graphId, ops)

правка любого блока готового сценария (до 20 ops): add_button, set_button_action, insert_step (любые блоки), update_node, delete_node, connect, disconnect, move_branch, add_trigger; опубликованный сценарий не меняется; нет подключения - 409 или allowMissingIntegrations

node_types_list(kind?, q?)

короткий каталог всех блоков, триггеров и действий конструктора

node_types_pick(task, limit?)

подбор блоков по описанию задачи: схемы 6 самых подходящих одним вызовом

node_type_schema(type)

поля, выходы, интеграция и пример config блока; несколько типов через запятую (до 8)

integrations_for_spec(botId, spec)

какие подключения нужны spec и что уже подключено

graph_structure(graphId, nodeId?)

блоки и связи сценария перед graph_edit

dialog_recent(botId?, limit?, cursor?)

последние диалоги с подписчиками: последнее сообщение, время, непрочитано, username

graph_texts(graphId) / graph_text_set(graphId, nodeId, text?, buttons?)

тексты и подписи кнопок готового сценария и их правка без смены связей

notify_link_status() / notify_link_start(platform)

привязка Telegram/MAX владельца для уведомлений: статус и одноразовая ссылка

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 сообщений.

type

Обязательно

Текст

Кнопки

TEXT

text (до 4096)

Telegram-HTML

до 8 URL-кнопок

PHOTO VIDEO AUDIO FILE VOICE

mediaUrl

подпись до 1024

до 8

VIDEONOTE (кружок)

mediaUrl

нет

до 8

GALLERY

mediaUrls — 2–10 картинок

подпись до 1024

нет

  • HTML: <b> <i> <u> <s> <code> <pre> <blockquote> <tg-spoiler> <a href="https://…">, перенос строки — \n.

  • Кнопки только URL [{text, url}] — callback-кнопок в рассылке нет. Медиа — сначала upload_file, потом его url.

  • Аудитория — подписчики бота, фильтр тегами: tagsAll (есть все), tagsNone (нет ни одного). До 50 000 на бота, до 20 ботов одного владельца за раз.

  • scheduledAt — ISO 8601; без часового пояса считается московским. Пусто — отправить сейчас.

  • Рассылки — на платном тарифе; квота получателей месячная. При нехватке — ошибка с прямой ссылкой на смену тарифа.

  • У Instagram-ботов рассылок нет.

{"name": "Распродажа", "botIds": ["<id>"], "tagsAll": ["клиент"], "scheduledAt": "2026-10-10T10:00",
 "messages": ["<b>Только сегодня</b> — скидка 30%",
              {"type": "PHOTO", "mediaUrl": "https://…/sale.jpg", "text": "Успей до полуночи",
               "buttons": [{"text": "В магазин", "url": "https://shop.example"}]}]}

Когда нужен браузер

Через API не делается то, что требует входа пользователя у стороннего сервиса, оплаты или входа в аккаунт. Такие инструменты не падают, а возвращают {needsBrowser: true, url, instruction} или ошибку со ссылкой:

Ситуация

Ссылка

нет токена / токен отозван

/bots/mcp-tokens — создать токен и прислать агенту

Google Таблицы (connect_integration)

одноразовая ссылка согласия Google (OAuth)

Instagram (create_bot, connect_integration)

/bots/instagram — подключается входом через Instagram (OAuth); нужен Instagram-аккаунт Business/Creator

лимит тарифа, рассылки на бесплатном (HTTP 402)

upgradeUrl из ответа или /bots/subscription

свой домен сайта

DNS у регистратора: A-запись на dnsTarget из site_domains


Формат графа и проверка

Граф — контейнер retensy-bot-graph (nodes[] + edges[]). Полная схема узлов/хэндлов и правила валидатора — в скилле:

Локальная проверка графа перед заливкой:

# Telegram (по умолчанию)
node skills/build-bot-funnel/validate.mjs path/to/import.json
# Instagram-бот
node skills/build-bot-funnel/validate.mjs path/to/import.json --platform=INSTAGRAM
# MAX-бот
node skills/build-bot-funnel/validate.mjs path/to/import.json --platform=MAX

Перенос воронки из другого конструктора

Есть готовая воронка в BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot или любом другом сервисе — скилл rebuild-funnel-from-builder учит агента перенести её в Retensy: разобрать export JSON/текст/скриншоты/пересказ → построить инвентарь блоков → сопоставить с реальными типами узлов Retensy (таблица в reference/mapping.md) → прямо спросить про то, что не мапится, вместо того чтобы выдумывать замену → собрать граф → проверить validate.mjs/dry_run → залить новым черновиком (никогда не поверх текущего сценария) → опубликовать только после явного подтверждения. Перенос самих подписчиков (не графа) — отдельно, через migration_presets/migration_preview/migration_commit (CSV).


Разработка

git clone https://github.com/retensy/retensy-mcp
cd retensy-mcp
RETENSY_MCP_TOKEN=zmcp_... node src/index.mjs   # стартует stdio MCP-сервер

Зависимостей нет — это голый JSON-RPC по stdio (протокол MCP 2024-11-05).

Обновления

При старте сервер сверяет свою версию с npm (результат кэшируется на 6 часов в ~/.retensy-bot-graph/update-check.json). Если вышла новая — уведомление появится в setup и в первом ответе инструмента.

  • Установка через npx (вариант B): держите в конфиге @retensy/mcp@latest — тогда свежая версия подтягивается при запуске. Если пакет установлен глобально, сервер сам запустит npm i -g @retensy/mcp@latest в фоне (отключается RETENSY_MCP_AUTOUPDATE=0).

  • Установка как плагин (вариант A): обновляйте плагин/git pull — npm тут не при чём, исполняется файл репозитория.

Важно: запущенный процесс не может подменить собственный код — обновление вступает в силу после перезапуска MCP-сервера. Нет сети или npm недоступен — проверка молча пропускается, работа не ломается.

Каталог действий без обновления пакета

С версии 0.42 сервер при старте загружает единый каталог действий сервиса (GET /api/agent-tools/catalog — тот же список, что у «Чата с ИИ» в кабинете) и регистрирует его инструменты динамически; вызов идёт через POST /api/agent-tools/invoke, права токена, тариф и подтверждение проверяет сервер. Новые действия появляются без релиза npm: каталог обновляется раз в 10 минут, клиент получает notifications/tools/list_changed. Каталог кэшируется в ~/.retensy-bot-graph/catalog-*.json. Действия с подтверждением (удаление, рассылка всем, публикация) повторяются с confirmToken из ответа сервера (привязан к аргументам, живёт 5 минут) только после явного согласия пользователя. Каталог только добавляет новые имена и не перекрывает встроенные инструменты; для не-localhost RETENSY_BASE_URL нужен https. Выключить: RETENSY_MCP_CATALOG=off.

Настоящее согласие человека для деструктивных инструментов - это подтверждение вызова в самом MCP-клиенте (такие инструменты помечены destructiveHint): не включайте для них автоодобрение.

Отчёты о неудачах (телеметрия)

Чтобы мы узнавали, каких возможностей не хватает, при неудаче инструмента отправляется анонимный отчёт: неизвестный инструмент, отказ публикации (errors[]), ошибка API.

Отчёт уходит на POST {RETENSY_BASE_URL}/api/mcp/report — то есть на тот же сервер, с которым вы и так работаете. Адреса чата/вебхука, куда мы складываем отчёты, в пакете нет: он живёт в переменной окружения на сервере. Так его нельзя вытащить из пакета и залить, а мы можем сменить приёмник без выпуска новой версии.

Что уходит: имя инструмента, категория неудачи, текст ошибки, ключи аргументов, версия, платформа и анонимный id установки (хэш от имени хоста и домашнего каталога — не сами значения). Что НЕ уходит никогда: токены, cookie, пароли, креды интеграций, содержимое графов и текстов рассылок. Значения аргументов по умолчанию скрыты — присылаются только безопасные поля вроде graphId/botId/kind.

Если персональный токен настроен, он прикладывается к отчёту — тогда мы видим, у кого именно не хватило возможности, и можем ответить. Токен прикладывается только когда приёмник совпадает с RETENSY_BASE_URL: на сторонний RETENSY_MCP_REPORT_URL он не отправляется.

Переменная

Значение

RETENSY_MCP_TELEMETRY=off

полностью выключить отчёты

RETENSY_MCP_TELEMETRY=full

присылать и значения аргументов (для отладки своей установки)

RETENSY_MCP_REPORT_URL=<url>

свой приёмник (напр. локальный сервер), вместо /api/mcp/report

Отчёты дедуплицируются и ограничены 20 на запуск, отправка не блокирует ответ инструмента (таймаут 4 с) и при сбое сети молча игнорируется. На сервере — свои лимиты (30 в час с адреса, 500 в час всего), так что отчёты нельзя использовать для заливки.

Отдельно: если токен ещё не настроен вовсе, отчёт не отправляется — это обычное состояние нового пользователя, а не пробел в возможностях.

Работа партнёра с несколькими проектами

Партнёр настраивает MCP один раз, своим собственным токеном — дальше тот же токен работает со всеми проектами, доступ к которым ему дали клиенты.

  • Токен = аккаунт, не проект. zmcp_... всегда идентифицирует тебя. Он не привязан к конкретному боту или сайту — какие проекты видны и что с ними можно делать, решает не токен, а твоя роль в каждом отдельном проекте.

  • Доступ — через приглашение, а не передачу токена. Чтобы ты поработал в боте клиента, клиент сам приглашает тебя соредактором (в боте → «Доступ» → email или ссылка, роль Viewer/Editor/Admin). Свой MCP-токен или пароль клиент никогда не присылает — и ты его не просишь.

  • list_bots и site_list показывают всё сразу: твои собственные проекты и те, куда тебя пригласили — у чужих в ответе есть ownerName (имя владельца) и accessRole (твоя роль в этом конкретном проекте: OWNER / ADMIN / EDITOR / VIEWER). Так ты сразу видишь, где ты владелец, а где гость с ограниченной ролью.

  • Передавай botId/siteId явно в каждом вызове инструмента — ассистент не хранит «текущий проект». Переключение между проектами клиентов — это просто другой botId в следующем вызове, оно не меняет твой аккаунт и не путает данные между проектами.

  • Доступ проверяется заново на каждый запрос. Если клиент поменял тебе роль или вовсе убрал из соредакторов, следующий же вызов к этому проекту откажет — без повторной настройки токена и без задержки.

  • Бери минимально нужную роль. Viewer — чтобы посмотреть и оценить задачу, Editor — чтобы собирать и публиковать сценарии, Admin — только если по договорённости настраиваешь рассылки или параметры бота.

  • Никогда не проси пароль от аккаунта клиента или его MCP-токен. Единственный штатный способ работать в чужом проекте — приглашение с ролью; свой токен отзывай сам в кабинете, если он утёк.

Безопасность

Токен = доступ к аккаунту по API в пределах его прав. Выдавай агенту минимально нужные права (для знакомства — «Только чтение»). Не коммить токен; держи в env. В конфигах храни ссылку ${RETENSY_MCP_TOKEN}, не само значение.

Лицензия

MIT — см. LICENSE.

Инструменты агента на запись

agent_update {patch:{tools:[...]}} включает агенту инструменты записи по одному: создать/обновить сделку и контакт в amoCRM (через подключение из «Подключений»), добавить строку в Google Таблицу, POST на свой API (SSRF-защита, без редиректов), сохранить поле/тег подписчика, передать оператору. У каждого — JSON-схема аргументов (argsSchema), шаблоны {аргумент}, подтверждение у пользователя (confirmBeforeRun, по умолчанию включено для внешних записей), лимиты на диалог и сутки, идемпотентность. Список проверяется локально до отправки. Проверка — agent_tool_test (песочница по умолчанию), журнал — agent_tool_calls. Не работает в публичном веб-чате агента.

Available Tools

30 tools
article_getA

Получить статью блога по slug (GET /api/articles/by-slug/{slug}) — публичное чтение, в т.ч. чужие. Возвращает title, content (Markdown), excerpt, coverImage, viewCount.

Inputs: slug (required).

article_listA

Список СВОИХ статей блога retensy (GET /api/articles/my): id, slug, title, viewCount, даты. id нужен для article_update, slug — публичный адрес /articles/{slug}. Read-only.

Inputs: no named parameters.

article_publishA

Опубликовать НОВУЮ статью блога retensy (POST /api/articles). content — Markdown (как README на GitHub: заголовки, списки, таблицы, код, картинки по URL). title необязателен: если не передать, заголовком станет первая строка вида «# Заголовок», и она убирается из текста. Обложку можно задать явно через cover (URL картинки) — иначе берётся первая картинка из текста; excerpt (SEO-описание) тоже можно задать явно, иначе генерируется из текста. Возвращает статью с id и slug + публичный URL.

Inputs: content (required), cover, title, excerpt.

article_updateA

Обновить СВОЮ статью по id (PUT /api/articles/{id}; id бери из article_list). content — Markdown; title необязателен (как в article_publish, иначе берётся из «# ...»). Только владелец — чужую вернёт 403.

Inputs: id (required), content (required), title.

clone_graphA

Склонировать граф в новый DRAFT «… (copy)» — безопасно итерировать поверх опубликованного.

Inputs: graphId (required).

copy_graphA

Скопировать граф в ДРУГОГО бота (в т.ч. на другую платформу). Возвращает {graphId, sourcePlatform, targetPlatform, notes[]}. notes[] помечают, что адаптировано (severity=TRANSFORM, напр. вопрос-контакт → ввод телефона текстом), что требует ручной правки (MANUAL, напр. условие SUBSCRIBED в MAX) и особенности платформы (INFO). Авто-адаптация узлов реализована для Telegram⇄MAX; при копировании в/из Instagram-бота граф копируется без трансформаций — несовместимые узлы будут отмечены при публикации (IG-allowlist). preview=true — только проверка совместимости, без копирования. Тот же бот запрещён (для дублирования есть clone_graph).

Inputs: graphId (required), targetBotId (required), preview.

create_graphB

Создать пустой граф (DRAFT) в боте. Возвращает граф с id.

Inputs: name (required), botId (required).

create_graph_from_templateA

Создать граф (DRAFT) из шаблона (см. list_templates). Возвращает граф с id — дальше правь через update_graph.

Inputs: botId (required), templateId (required), name.

delete_fileB

Удалить файл из библиотеки /bots/files по id (DELETE /api/bots/media/{id}). Освобождает место в хранилище тарифа.

Inputs: id (required).

delete_graphA

Удалить граф. Активный (опубликованный и назначенный боту) удалить нельзя — будет 409; сначала переключи активный через set_active_graph.

Inputs: graphId (required).

dry_runB

Прогнать сценарий без публикации. kind: command|callback|text.

Inputs: kind (required), value (required), graphId (required), presetTags, +2 more.

edit_graph_liveA

РЕКОМЕНДОВАННЫЙ способ правки СУЩЕСТВУЮЩЕГО (часто живого/опубликованного) сценария: редактирует ТОТ ЖЕ graphId НА МЕСТЕ (id не меняется) и сначала снимает авто-бэкап текущего состояния в один rolling-граф «🔙 Авто-бэкап». НЕ клонирует и НЕ создаёт новый активный граф. Открытые редакторы перечитают граф вживую (external_update), бот применит изменения сразу (читает активный граф заново из БД). Используй ВМЕСТО clone+publish, когда нужно поправить сценарий, который уже открыт/в проде. ВАЖНО: PUT не валидирует — перед вызовом прогони offline validate.mjs и dry_run.

Inputs: graphId (required), name, edges, graph, +4 more.

get_graphA

Получить граф по graphId. Для БОЛЬШИХ графов (десятки узлов JSON может превысить лимит токенов) используй summary:true (компактная сводка: id/type/title/позиции + рёбра) или saveToFile (записать полный граф на диск и вернуть сводку+путь — потом правь файл и заливай через update_graph/edit_graph_live с graphFile).

Inputs: graphId (required), summary, saveToFile.

graph_analyticsA

Аналитика прохождения сценария по узлам (GET /api/bots/graphs/{graphId}/analytics): сколько пользователей дошло до каждого узла — видно, где отваливается воронка. Read-only.

Inputs: graphId (required).

import_funnelA

Всё за раз: создать граф, залить узлы/рёбра, (опц.) dry-run /start, опубликовать. Граф можно передать инлайном (graph) или файлом (graphFile).

Inputs: botId (required), name, graph, dryRun, +2 more.

list_botsA

Список ботов пользователя (id, имя, статус).

Inputs: no named parameters.

list_bot_usersA

Пользователи (подписчики/лиды) бота, постранично (GET /api/bots/{botId}/users). Опц. page (с 0), size (по умолч. 25), query (поиск по имени/username/id). Read-only.

Inputs: botId (required), page, size, query.

list_channelsB

Список каналов/групп, подключённых к боту (chatId, title, type, статус бота, дата). chatId — числовой id для условия SUBSCRIBED («Подписан на канал»).

Inputs: botId (required).

list_filesA

Список файлов в библиотеке /bots/files (GET /api/bots/media) + использовано/лимит байт. Бери готовые url отсюда, чтобы не загружать одно и то же повторно.

Inputs: no named parameters.

list_graphsC

Список графов (сценариев) бота.

Inputs: botId (required).

list_templatesA

Список готовых шаблонов воронок (id, имя, описание). Можно стартовать граф из шаблона вместо сборки с нуля.

Inputs: no named parameters.

patch_graphA

Точечная правка БОЛЬШОГО/живого графа без отправки графа целиком: сервер сам берёт граф по graphId, делает строковые замены в его JSON, проверяет валидность и заливает обратно НА МЕСТЕ (с авто-бэкапом). Идеально, когда граф слишком велик, чтобы передавать его целиком через update_graph/edit_graph_live — напр. сменить id канала в условиях SUBSCRIBED, ссылки кнопок, тексты. replacements: [{find, replace}] — заменяются ВСЕ вхождения; делай find максимально специфичным, чтобы не задеть лишнее. preview=true — только показать число совпадений, ничего не сохраняя. Бот применит изменения сразу (читает активный граф заново из БД).

Inputs: graphId (required), replacements (required), backup, preview.

publish_graphB

Опубликовать граф. Вернёт publishedGraphId или errors[] (code, nodeId, message).

Inputs: graphId (required).

rename_graphA

Переименовать сценарий (работает и для опубликованных — имя не влияет на исполнение).

Inputs: name (required), graphId (required).

set_active_graphA

Назначить, какой опубликованный граф активен у бота (переключение живого сценария без перепубликации).

Inputs: botId (required), graphId (required).

set_tokenA

Сохранить персональный токен (zmcp_...), который пользователь создал на /bots/mcp-tokens. Применяется сразу, без рестарта.

Inputs: token (required).

setupA

Показать статус авторизации и пошаговую инструкцию подключения. Вызывай первым, если пользователь не знает, что делать, или при ошибке доступа.

Inputs: no named parameters.

update_graphA

Залить узлы/рёбра в граф (PUT, сырой replace без бэкапа). Для правок СУЩЕСТВУЮЩЕГО/живого сценария используй edit_graph_live. Принимает graphFile (путь к локальному файлу — НЕ нужно слать граф инлайном, удобно для больших графов), graph-контейнер или nodes/edges.

Inputs: graphId (required), name, edges, graph, +3 more.

upload_fileA

Загрузить файл в библиотеку /bots/files (POST /api/bots/media) и получить публичный URL для вставки в сценарий. Передай path (локальный файл) ИЛИ url (перезалить файл по ссылке в своё хранилище). Возвращает {id, url, mediaType, sizeBytes, originalName}. Полученный url ставь в медиа-карточку SEND_MESSAGE (image/video/audio/file/voice/videonote → поле url; gallery → urls[]) или в SEND_PHOTO.photoUrl. Лимит 50 МБ; типы: image/video/audio/pdf/zip/doc(x)/xlsx/pptx/txt (SVG запрещён); при нехватке места — HTTP 402.

Inputs: url, path, filename.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 30 tools

    Disambiguation3/5

    The graph-mutation cluster (update_graph, edit_graph_live, patch_graph, clone_graph, copy_graph) has genuinely overlapping purposes, and several tools create graphs (create_graph, create_graph_from_template, import_funnel). The very detailed descriptions explicitly tell the agent which to pick and when, which rescues the set from being confusing, but the boundaries are still fuzzy.

    Naming Consistency3/5

    Most tools follow a clear snake_case verb_noun pattern (list_graphs, create_graph, delete_file). However, the blog tools break the convention with noun_verb order (article_list, article_get, article_publish, article_update), and a few outliers (dry_run, graph_analytics) drop the verb entirely.

    Tool Count3/5

    30 tools is on the heavy side and spans two loosely related domains (funnel/graph builder plus a blog article API). The overlapping graph-editing tools suggest some redundancy, though the overall breadth is defensible given the platform's scope.

    Completeness4/5

    The graph/funnel lifecycle is well covered (create, get, list, clone, copy, update, publish, delete, active-switch, analytics, dry-run) and files/templates/users/links each have read and write paths. Minor gaps remain: articles have list/get/publish/update but no delete, and there is no bot create/edit beyond list_bots.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants like Claude, Cursor, and Copilot to manage Telegram bots through 68 tools covering the TeleBotHost Developer API, including bot management, messaging, and analytics.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to interact with, test, click buttons on, and verify Telegram bots end-to-end via MTProto, including messaging, inline queries, media exchange, and automated test suites.
      1
      MIT