@retensy/mcp
This MCP server lets you manage Retensy bots, scenarios, media, and blog articles through the Retensy API.
Authenticate and configure the connection with
setupandset_token.Inspect bots, scenarios, channels, subscribers, tracking links, and scenario analytics.
Create, rename, clone, copy, delete, and activate bot scenarios.
Build scenarios from templates or import complete funnels.
Retrieve graphs in full or compact form, and save large graphs to local files.
Edit live graphs in place with automatic backups, or patch large graphs with string replacements.
Run dry-run tests and publish graphs.
Upload, list, and delete media files in the
/bots/fileslibrary.Publish, read, and update blog articles in Markdown.
Enables building and publishing Instagram bot funnels with limited node support, using OAuth (no token). Supports comment, Direct, story reply, and mention triggers, with DELAY up to 24h and ASK_QUESTION only for TEXT/EMAIL/PHONE/NUMBER/CONTACT; broadcasts are not supported.
Enables building and publishing MAX bot funnels and automations, including command, callback, and text triggers. Unsupported features such as SUBSCRIBED conditions and reply keyboards produce soft warnings.
Enables building and publishing Telegram bot funnels and automations, including /start triggers, commands, callback handling, text replies, broadcasts, media cards, and full graph creation/publishing via the retensy /bots service.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@retensy/mcp build a /start funnel with a greeting and 3 buttons, then publish it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
retensy-mcp
MCP-сервер (+ скилл для Claude Code) для сборки и публикации воронок/автоматизаций ботов (Telegram, MAX и Instagram) в сервисе retensy /bots: из текстового описания → валидный граф сценария → заливка и публикация через API.
Быстрый старт
Получи токен. Залогинься на https://bots.retensy.com → открой
/bots/mcp-tokens→ создай токен → скопируй секретzmcp_...(показывается один раз).Подключи у своего клиента (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@retensyCursor — Settings → MCP → Add new MCP Server (или
.cursor/mcp.jsonв проекте) — тот же JSON-объект, что и для Claude Desktop выше (mcpServers.retensy-mcpсcommand/args/env).Собери первую воронку. Опиши сценарий словами агенту — он сам соберёт граф и опубликует (см. «Использование»), либо перенеси готовую воронку из другого сервиса — см. «Перенос воронки из другого конструктора» ниже.
Проверить подключение в любом клиенте: спроси агента «настрой подключение» — вызовет 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) → |
| Полный функционал |
MAX | Токен бота (MasterBot в MAX) → | Команды, callback, текст | Без SUBSCRIBED/reply-клавиатур (мягкие предупреждения) |
Вход через Instagram (OAuth) в кабинете | Комментарий/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.
Авторизация — персональный токен
Токен действует от твоего имени в пределах выбранных прав (см. «Права токена» ниже).
Залогинься на https://bots.retensy.com → открой
/bots/mcp-tokens.Выбери права токена (пресет «Только чтение», «Полный доступ» или свой набор) и, при желании, срок действия → создай токен → скопируй секрет
zmcp_...(показывается один раз).Передай токен любым способом:
просто пришли его агенту в чат — он вызовет инструмент
set_tokenи сохранит токен в~/.retensy-bot-graph/token(применяется сразу, без рестарта), илиenvв.mcp.json(Вариант B), илипеременной окружения: PowerShell
setx RETENSY_MCP_TOKEN "zmcp_...", bashexport 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-клиент только объясняет отказ. Но права крупные — выдавай токену только то, что нужно для задачи.
Право | Что разрешает | Примеры инструментов |
| любое чтение: списки, карточки, аналитика, превью, поиск, |
|
| создание и изменение ботов, сценариев, цепочек, интеграций, ИИ-агентов, базы знаний, черновиков рассылок. Правка опубликованного сценария сразу меняет ответы бота подписчикам; можно сменить ключи и вебхуки интеграций; |
|
| сайты, лиды, VK-лендинги, статьи |
|
| теги/переменные подписчиков, импорт, передача диалога оператору, записи. |
|
| всё, что доходит до живых людей без участия человека: рассылки, ответы, посты, а также включённая цепочка без согласования постов (approvalMode |
|
| деньги и ключи, которые тратят бюджет |
|
| любое удаление и массовая выгрузка ПДн |
|
Пресеты: «Только чтение» =
read; «Полный доступ» = все семь. По умолчанию в кабинете предлагаетсяread+write:bots+write:sites— собирать ботов и сайты. Это не «безопасный» набор: он видит ПДн подписчиков и заявок и меняет живые ответы ботов и ключи интеграций. В нём нет только рассылок, оплаты, удаления и выгрузки.Цепочки и расписание с одним
write:bots: цепочку можно создать выключенной или с согласованием каждого поста (approvalMode: ALL), сценарий по расписанию, с отправкой в заданный чат/канал (target.modechat/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 | Назначение |
| статус авторизации + пошаговая инструкция подключения |
| сохранить присланный токен |
| несколько аккаунтов: токены хранятся под именами в |
| список ботов ( |
| подключить бота Telegram/MAX по токену; |
| код вставки чат-виджета на сайт |
| остановить / запустить бота |
| графы (сценарии) бота |
| каналы/группы, подключённые к боту (chatId для условия SUBSCRIBED) |
| подключённые сервисы (amoCRM, Битрикс24, GetCourse, Я.Метрика, ЮKassa): |
| подключить/обновить сервис; без кредов — какие поля нужны; Google Таблицы → ссылка входа Google, Instagram → ссылка на кабинет |
| удалить подключение |
| каталог Integration Core: поля подключения ( |
| статус подключения: |
| живая проверка ключа во внешнем сервисе от имени владельца (без побочных эффектов) |
| URL ингресса для триггера «Внешние события» ( |
| разовый пост в канал/группу Telegram или MAX (раздел «Публикации»); файл — из |
| получить граф; |
| создать пустой граф (DRAFT) |
| залить узлы/рёбра (PUT); |
| правка живого графа НА МЕСТЕ + авто-бэкап (рекомендуется для прода) |
| строковые замены в JSON графа на сервере (для больших/живых графов) |
| прогон без публикации |
| публикация (вернёт |
| снять дополнительный сценарий с публикации (основной — 409) |
| история версий сценария (снимки при публикации, правках живого графа, ручные); с |
| откат сценария на версию = публикация снимка (проверки как у |
| всё за раз: create → update → dry-run → publish |
| готовые шаблоны воронок (~30, ниша и каналы в карточке; фильтры по нише, каналу, тексту); те же открыты публично на |
| граф из шаблона (DRAFT) |
| копия графа в новый DRAFT |
| переименовать сценарий |
| переключить активный (живой) граф бота |
| удалить граф (активный — нельзя, 409) |
| загрузить файл в /bots/files → публичный |
| файлы библиотеки /bots/files + использовано/лимит байт |
| удалить файл из /bots/files |
| прохождение сценария по узлам (где отваливается воронка) |
| подписчики/лиды бота (постранично, поиск |
| стартовые трекинговые ссылки бота с UTM |
| сайты пользователя (id, mode, url, publishedRevision, status — |
| новый сайт из блоков → |
| модель сайта ( |
| компактный справочник модели и операций (~10 КБ); |
| правка операциями ( |
| библиотека шаблонов блоков для |
| опубликовать черновик → |
| вернуть прошлую публикацию |
| картинка/видео в сайт → |
| свои домены: list / add / check / remove (число — по тарифу) |
| заявки из форм (поля, UTM, статус доставки) |
| куда доставлять заявки: бот уведомлений, почта, вебхук, вебхук-сценарий, amoCRM, «Интеграция» ( |
| рассылки + счётчики разделов (черновики/запланированные/отправленные/повторы) |
| рассылка целиком: статус, счётчики, сообщения, причины ошибок |
| оценка охвата: сколько подписчиков получат рассылку; |
| отправить сейчас / запланировать; по нескольким ботам; или запуск сценария; |
| сохранённые сегменты аудитории: list / create {name, audienceFilter} / delete {segmentId}; дальше |
| закрытый бот и список доступа: get / settings {privateBot, deniedMessage} / add {items[{kind TG_ID|USERNAME|PHONE, value, note?}] или text} / remove {entryId} / clear {confirm:true}; проверка в сценарии - узел |
| пресеты блоков (аккаунт или бот). Секретные заголовки хранятся зашифрованно и приходят ссылками |
| входящие запросы сценария-вебхука (последние 50 за 7 дней, секреты скрыты): list / listen (тестовый URL |
| тестовый запрос с сервера (SSRF-защита, 15 с, 1 МБ): status, headers, body и |
| тихие часы бота (по умолчанию выкл): get / set {enabled, quietFrom, quietTo, timezone?}; рассылки в окне переносятся на его конец, пояс - подписчика (переменная |
| тест рассылки себе: на привязанный Telegram владельца или в чат подписчика; мимо квоты и очереди |
| отменить запланированную/идущую (для группы — |
| повторяющиеся рассылки: list / create (DAILY·MONTHLY·YEARLY, те же |
| черновики: list / get / create / update / delete |
| копия рассылки или черновика — новый черновик «… (копия)» |
| мульти-бот группа с дедупом/распределённым запуском: |
| свои статьи блога (id, slug, title, просмотры) |
| статья по slug (Markdown content, excerpt, обложка) |
| новая статья (Markdown; title из |
| обновить свою статью по id |
| список ИИ-агентов (id, имя, статус) |
| настройки агента: язык, тон, длина/формат ответа, инструкции, темы, |
| создать агента; вместе с ним создаётся база знаний ( |
| частично изменить настройки ( |
| опубликовать; 409 |
| счётчики документов/фрагментов базы знаний |
| проверить ответ в песочнице (тратит бюджет ИИ — не вызывай массово) |
| вопросы без ответа за период (7|30|90, по умолчанию 30) |
| вопрос к аналитике по-русски: бэкенд переводит его в вызов белого списка запросов по данным владельца, ответ с числом, таблицей и «как посчитано»; тратит квоту ИИ |
| авто-FAQ: list / generate / approve (в базу знаний как QA) / dismiss |
| проверка агента ИИ-клиентами по тест-кейсам: диалог в песочнице, ИИ-судья (PASS/FAIL, причина, цитата), сравнение с прошлым прогоном. Тратит бюджет ИИ — нужен |
| тест-кейсы, история прогонов и полный прогон (последний или по |
| документы базы знаний агента (источник, статус, фрагменты) |
| добавить пары вопрос-ответ ( |
| добавить источник «Текст/инструкция» |
| добавить сайт обходом страниц; |
| переиндексировать файл из оригинала («Повторить»); |
| базы знаний: список / новая (база агента создаётся с ним — |
| удалить документ из базы знаний вместе с фрагментами |
| карточка подписчика: теги, переменные, ai_summary |
| журнал запусков с шагами — проверка, что сценарий реально выполнил действия (CRM, уведомление, HTTP) |
| переписка с подписчиком / ответ оператора (уходит реальному человеку) |
| передать диалог оператору (бот и ИИ молчат) / вернуть боту |
| добавить/обновить подписчиков пачкой JSON ( |
| журнал прогонов бота / один прогон с шагами (статус |
| журнал прогонов одного сценария, включая headless (вебхук, заявки сайта, |
| удалить бота навсегда (только по явной просьбе) |
| вид чат-виджета: прочитать / изменить (поля накладываются на текущие) |
| переименовать подключение или заменить ключи |
| журнал вызовов внешних сервисов из сценариев (ошибки, попытки, runId) |
| статус заявки сайта: |
| переименовать бота (пустое имя — |
| дополнительные Telegram-боты (мультиканальность); каналы/группы для постинга — |
| стартовая ссылка (диплинк на узел) / удаление; список — |
| UTM-источники подписчиков / итоги A/B-развилки ( |
| Отчёт источник -> подписчики/покупатели/выручка (RUB + Stars)/конверсия, даты YYYY-MM-DD |
| Здоровье бота: статус OK/WARN/CRIT, проблемы с подсказками (токен, 409, опрос, ошибки сценариев, платежи, конверсия, ИИ-агент); без botId - все боты |
| Воронка владельцев и события шагов (админ платформы), только агрегаты |
| Причины отписки: блокировки, кнопки, темы свободных ответов (ИИ раз в неделю) |
| удалить базу знаний целиком (база агента — только вместе с агентом) |
| снять агента с публикации / удалить (409 |
| заявки сайта: всё прочитано / удалить заявку / CSV |
| выгрузка подписчиков |
| сбросить сессию подписчика: позиция, метки, переменные (для повторного теста воронки) |
| календари записи (id → |
| новый календарь: окна |
| правка (поля накладываются на текущие) / удаление |
| свободные слоты |
| брони: список (или только ждущие подтверждения) / ручная запись (занятый слот — ошибка «занят») / отмена |
| подтвердить/отклонить бронь при |
| билеты на события: события и типы билетов, участники, ручная отметка входа и отмена (последние два с подтверждением) |
| ключи переменных (с выведенным типом) и теги бота — для построителя фильтра |
| фильтр+сортировка подписчиков: один бот или кросс-бот (без |
| массово добавить/снять теги / установить/снять переменные у выбранных подписчиков |
| из каталога сервера. Подписчики по ВСЕМ ботам за один вызов: новые, активные, всего, заблокировали, итого и топ ботов. Считает сервер, ботов по одному запрашивать не нужно |
| из каталога сервера. Точная сводка заявок по всем сайтам: счётчики по статусам, сайтам и |
| из каталога сервера. Записи по всем календарям: сколько ждут подтверждения и сколько предстоящих |
| из каталога сервера. Массово сменить статус заявок по условию, до 500 за раз, id не нужны. Только свои сайты. Нужен |
| из каталога сервера. Массово подтвердить ( |
| из каталога сервера. Поставить/снять теги всем подписчикам, подходящим под условие ( |
| потоковая выгрузка ТЕКУЩЕЙ отфильтрованной выборки, |
| кросс-бот поиск по «Диалогам» — имя/username/id/текст сообщения |
| месячная квота публикаций владельца (общая для Telegram/MAX/Instagram/VK) |
| подключённые VK-сообщества / подключить токеном сообщества (проверяется живым вызовом VK) / отключить |
| пост на стену VK (только текст/фото — без видео), списывает ту же квоту публикаций |
| каталог источников миграции подписчиков (BotHelp/SaleBot/Senler/Leadteh/Smartsender/ManyChat/универсальный CSV) |
| пробный прогон CSV (ничего не пишет): без |
| реальный импорт подписчиков тем же |
| пробный прогон переноса ботов zaytsv.com в Retensy (только администратор), ничего не пишет: план по графам, подписчики новые/слитые, что не переносится |
| реальный перенос тем же планом, идемпотентно; ботов не запускает и не останавливает |
| dry-run структурной конвертации ОДНОГО сценария BotHelp (его собственный JSON-экспорт, не CSV) в граф Retensy — ничего не пишет, возвращает отчёт |
| то же + сохраняет граф (DRAFT); идемпотентно по |
| цепочки публикаций («Публикации» → «Цепочки», автопостинг source → граф обработки/назначений) / одна цепочка как хранится (legacy либо граф) |
| граф цепочки ВСЕГДА graph-shaped |
| создать / изменить цепочку целиком ( |
| включён ли Instagram, подключённые аккаунты, путь подключения (бета: только тестеры приложения); в IG уходят только посты с фото или видео |
| с тремя необязательными полями создаёт выключенную цепочку Telegram-канал -> Instagram; иначе: |
| офлайн-проверка графа (зеркало серверного |
| одним вызовом: все TG/MAX-каналы по ботам владельца + VK-аккаунты — собрать «1 источник → N каналов» без ручного обхода |
| удалить цепочку (теряется история заданий) |
| включить / поставить на паузу приём новых постов источника |
| история заданий цепочки, новые сверху (бэкенд без постраничной выдачи — |
| согласовать / отклонить задание, ждущее подтверждения ( |
| повторить проваленное задание вручную, минуя бэкофф |
| KPI+тренд сайта: просмотры, клики (только с |
| сырые события сайта постранично ( |
| новые подписчики/активность бота по дням (дашборд аналитики, диапазон до 92 дней) |
| дневной ряд прогонов сценария |
| проверить инструмент агента напрямую, без модели — бюджет ИИ не тратится. Чтение: |
| журнал вызовов инструментов записи агента: кто/когда/аргументы без секретов/результат |
| метаданные вложения заявки + ссылка на скачивание (сам файл через MCP не передаётся — HEAD-запрос, не GET) |
| сценарии автора, включая вебхук-сценарии ( |
| создать сценарий: без |
| сценарий целиком — граф + |
| привязка выхода вебхук-сценария, заменяется ЦЕЛИКОМ (без |
| опубликовать вебхук-сценарий (бот-сценарий — через |
| выпустить новый секрет входа вебхук-сценария — старый сразу перестаёт приниматься |
| API-ключи публичного чата агента ( |
| каталог пакетов ответов ИИ сверх тарифа + текущий баланс ( |
| купить пакет — возвращает ссылку на оплату, деньги не списываются этим вызовом |
Магазин (каталог)
Tool | Назначение |
| создать/обновить товар по |
| категории магазина: |
| создать (без |
| товары: поиск, сортировка ( |
| характеристики магазина; сводка по каталогу, по которой ИИ предлагает набор фильтров под нишу (из каталога сервера) |
| создать/изменить и удалить характеристику ( |
| массовое заполнение характеристик у товаров: сначала предпросмотр с примерами, применение только после подтверждения |
| SEO-шаблоны витрины ( |
| передача магазина (каталог, настройки, промокоды, заказы) и сайтов другому аккаунту по одноразовому коду; код, созданный через MCP, заработает после подтверждения владельцем в кабинете (/bots/transfer); ключи ЮKassa, 1С и токены не переносятся, их список в чек-листе |
`catalog_bulk_preview(filter | ids, action, ...) |
Магазин B2B (заявки на расчёт, счета, группы, доставка)
Паритет с REST /api/bots/commerce/... и ИИ-инструментами кабинета (shop_*). Все изменяющие инструменты требуют confirm:true (после явного согласия пользователя). Ответ на заявку, смена статуса и отметка оплаты уведомляют покупателя и необратимы. Секреты не отдаются: у групп вместо joinCode приходит joinCodeSet, расчётный и корр. счёт продавца маскируются (****1234). Файлы (PDF счёта, вложение заявки, документ заказа) возвращаются base64 до 2 МБ либо сохраняются локально через savePath.
Tool | Назначение |
| заявки на расчёт ( |
| ответить ценой на заявку (по номеру позиции с 0), при |
| ручная смена статуса ( |
| выставить счёт (идемпотентно) / отметить оплату по счёту (нужно право токена |
| PDF счёта / вложение заявки: base64 или файл |
| документы заказа (pdf/xlsx/docx/jpg/png до 5 МБ, до 20 на заказ) |
| реквизиты продавца (патч) и признак |
| только чтение: чек-лист готовности реквизитов для счёта ( |
| группы покупателей, назначения |
| доставка по зонам ( |
| B2B-поля товара: единица измерения ( |
| типы цен, срок КП, автостатус после оплаты; напоминание о неоплаченном счёте ( |
| заявки магазина с сайта (SiteLead): |
| заявка на расчёт -> заказ quoted, покупателю уходит расчёт |
| одобрить заявку на опт: тег группы покупателей контакту |
| PDF коммерческого предложения (base64 до 2 МБ или файл) |
Список заказов и статус (order_list, order_status) по-прежнему из каталога сервера. Работает с backend, где выкачен контракт B2B (docs/shop/API_B2B.md).
Промокоды, возвраты и настройки кабинета (из каталога сервера)
Эти инструменты приходят из каталога сервера (GET /api/agent-tools/catalog) и появляются без обновления пакета. Все изменяющие требуют confirm:true и confirmToken (сервер сначала возвращает сводку «что будет сделано»).
Tool | Назначение |
| промокоды заказов магазина: |
| возвраты денег по заказу через ЮKassa: без |
| повторить непрошедший возврат (при неизвестном исходе — с тем же ключом), отметить «вернул вручную в кабинете ЮKassa», отказаться от точно непрошедшего возврата |
| рабочее время оператора, автоответ вне часов, SLA-предупреждение владельцу; настройка заменяется целиком |
| напоминание тем, кто начал оплату и не закончил, и результат |
| ответ бота на сообщения мимо сценария: готовый текст или ИИ-агент (с передачей человеку), итоги за 7 дней |
| произвольный сценарий из компактной спецификации (сообщения, вопросы text/number/phone/email/photo/file/choice, условия, кнопки-ссылки и переходы, метка и уведомление владельцу); только черновик, |
| правка любого блока готового сценария (до 20 ops): |
| короткий каталог всех блоков, триггеров и действий конструктора |
| подбор блоков по описанию задачи: схемы 6 самых подходящих одним вызовом |
| поля, выходы, интеграция и пример config блока; несколько типов через запятую (до 8) |
| какие подключения нужны spec и что уже подключено |
| блоки и связи сценария перед |
| последние диалоги с подписчиками: последнее сообщение, время, непрочитано, username |
| тексты и подписи кнопок готового сценария и их правка без смены связей |
| привязка Telegram/MAX владельца для уведомлений: статус и одноразовая ссылка |
| подключён ли бот к Telegram Business и какие аккаунты (подключение — в приложении Telegram) |
| создание бота через Managed Bots без ручного токена |
| согласия клиентов (152-ФЗ): журнал, отзыв, выгрузка CSV (персональные данные, право |
| каналы и группы, где бот администратор (публикация — |
| проверить сценарий без публикации: ошибки и предупреждения |
| поиск по базе знаний и история пересборок документа |
| чек-лист, последняя проверка, аналитика (7/30/90 дней) и рекомендации ИИ-агента |
| счётчики «требует внимания»: заявки, диалоги без ответа, интеграции, боты на паузе |
Рассылки
Сообщение рассылки — как в мастере кабинета: {type, text?, mediaUrl?, mediaUrls?, buttons?}, до 5 сообщений.
type | Обязательно | Текст | Кнопки |
|
| Telegram-HTML | до 8 URL-кнопок |
|
| подпись до 1024 | до 8 |
|
| нет | до 8 |
|
| подпись до 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} или ошибку со ссылкой:
Ситуация | Ссылка |
нет токена / токен отозван |
|
Google Таблицы ( | одноразовая ссылка согласия Google (OAuth) |
Instagram ( |
|
лимит тарифа, рассылки на бесплатном (HTTP 402) |
|
свой домен сайта | DNS у регистратора: A-запись на |
Формат графа и проверка
Граф — контейнер 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 он не отправляется.
Переменная | Значение |
| полностью выключить отчёты |
| присылать и значения аргументов (для отладки своей установки) |
| свой приёмник (напр. локальный сервер), вместо |
Отчёты дедуплицируются и ограничены 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 toolsarticle_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_linksA
Стартовые (трекинговые) ссылки бота с UTM (GET /api/bots/{botId}/links): code, метки, число стартов. Это точки входа в воронку. Read-only.
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
Scored across 30 tools
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.
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.
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.
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
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Build and change Telegram bots by chatting: create flows, edit them, undo changes, add templates.
Schedule and analyze posts on 12 networks, incl. Bluesky, Mastodon and Telegram, from any AI agent
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to send and receive messages, media, and files on Telegram, and manage chats via a bot token.1755 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Telegram Bot API, allowing them to send messages, forward messages, get bot information, and receive updates.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT