Инструменты MCP

MCP-сервер TukTuk отдаёт нейросети 48 инструментов: по одному на действие публичного API. Список собран из самого сервера, поэтому совпадает с тем, что агент увидит после подключения.

#Подключение за одну строку

Сервер запускается через stdio и требует только ключ API. Ключ выпускается в кабинете: Настройки проекта → API.

{
  "mcpServers": {
    "tuktuk": {
      "command": "npx",
      "args": [
        "-y",
        "https://docs.tuk-tuk.online/mcp/tuktuk-mcp.tgz"
      ],
      "env": {
        "TUKTUK_API_KEY": "tuk_sk_…"
      }
    }
  }
}

Без ключа сервер всё равно запустится и объяснит агенту, как ключ получить. Это лучше, чем молчаливый отказ на первом же вызове.

#С чего начать агенту

1. tuktuk_manifest: что доступно этому ключу прямо сейчас.
2. tuktuk_list_channels: через какой канал вы вообще можете говорить.
3. tuktuk_find_contact или tuktuk_list_contacts: найти собеседника.
4. tuktuk_read_messages: прочитать переписку перед ответом.
5. tuktuk_send_message: ответить.

Полный разбор сценариев: Сценарии для агента.

#Все инструменты

#Параметры

#tuktuk_manifest

Что умеет этот аккаунт TukTuk и что разрешено вашему ключу прямо сейчас. Вызовите первым, если не уверены, доступно ли нужное действие.

Право: достаточно валидного ключа.

Параметров нет.

#tuktuk_account

Баланс, тариф, лимиты и расход сообщений рабочего пространства. Лимиты приходят фактические, с учётом расширений, докупленных сверх тарифа; в subscription видно, из чего складывается счёт: цена тарифа плюс расширения. Полезно перед массовой отправкой: если canSend=false, отправка не пройдёт.

Право: account:read.

Параметров нет.

#tuktuk_dashboard

Сводка рабочего стола за 30 дней одним запросом: деньги (расход по дням, прогноз), объёмы сообщений по дням и каналам, сегодняшний поток по часам, диалоги без ответа, пиковые час и день, сегментация обращений. Только цифры: текстов переписки здесь нет.

Право: account:read.

Параметров нет.

#tuktuk_list_channels

Список подключённых каналов связи со статусом: Telegram, VK, Instagram, Авито, MAX, Email, SMS, чат-виджет. Отсюда берётся channelId для отправки. Секреты каналов не отдаются.

Право: messengers:read.

Параметров нет.

#tuktuk_find_contact

Найти контакт по телефону или email. Возвращает карточку клиента или ошибку «не найден».

Право: contacts:read.

#tuktuk_list_contacts

Список контактов с фильтрами: поиск по тексту, тег, канал, статус диалога, наличие телефона или email. Используйте, чтобы собрать аудиторию или найти нужного клиента.

Право: contacts:read.

#tuktuk_get_contact

Карточка контакта целиком: имя, каналы, теги, произвольные поля, статус.

Право: contacts:read.

#tuktuk_create_contact

Завести карточку клиента. Нужен, когда клиент пришёл извне: из формы, из CRM, из вашей базы. Для отправки создавать контакт заранее не обязательно, tuktuk_send_message сделает это сам.

Право: contacts:write.

#tuktuk_update_contact

Обновить карточку: имя, телефон, email, теги, произвольные поля, статус диалога, архив. Установите chainsBlocked=true, если разговор ведёте вы и автоматические сценарии не должны вмешиваться.

Право: contacts:write.

#tuktuk_add_note

Внутренняя заметка в карточке клиента. Клиенту не уходит, видна команде. Хорошее место для выводов, которые вы сделали о клиенте.

Право: contacts:write.

#tuktuk_read_messages

История переписки с клиентом, свежие сверху. Содержит вложения и расшифровки голосовых. Читайте перед ответом, чтобы не повторять уже сказанное.

Право: messages:read.

#tuktuk_send_message

Отправить сообщение клиенту прямо сейчас: текст, картинку, голосовое, документ или письмо. Адресуйте по dialogId, либо по channelId вместе с phone, email или identifier: контакт найдётся или создастся. Отправка списывается с баланса рабочего пространства так же, как ответ оператора.

Право: messages:send.

#tuktuk_schedule_message

Поставить сообщение на конкретное время. Момент отправки держит платформа, поэтому вы можете завершиться сразу. Именно этот инструмент нужен для напоминаний, отложенных ответов и «напиши ему завтра в 9 утра».

Право: messages:send.

#tuktuk_list_scheduled

Что стоит в очереди и ещё не отправлено.

Право: messages:send.

#tuktuk_cancel_scheduled

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

Право: messages:send.

#tuktuk_upload_file

Положить файл по ссылке в постоянное хранилище TukTuk и получить URL, который не протухнет. Используйте перед отправкой вложения, если ваша ссылка временная или требует авторизации.

Право: files:write.

#tuktuk_preview_audience

Посчитать, сколько человек попадёт под фильтр и кому нельзя написать в выбранном канале. Делайте это до запуска рассылки: так вы не потратите деньги впустую.

Право: broadcasts:read.

#tuktuk_create_broadcast

Создать рассылку по сегменту клиентов. Создание не отправляет ничего: запуск отдельным вызовом tuktuk_start_broadcast. Темп задаётся delayMinSec и delayMaxSec, окно времени, windowFromMin и windowToMin.

Право: broadcasts:write.

#tuktuk_start_broadcast

Запустить рассылку. Если задан scheduledAt в будущем, она встанет в расписание. Работает только для черновика и запланированной: паузу продолжают через tuktuk_stop_broadcast с mode=pause и обратный вызов resume, завершённую повторяют через tuktuk_duplicate_broadcast.

Право: broadcasts:write.

#tuktuk_stop_broadcast

Остановить рассылку. mode=pause ставит на паузу, mode=cancel отменяет остаток без возможности продолжить.

Право: broadcasts:write.

#tuktuk_duplicate_broadcast

Копия рассылки. Завершённую или остановленную рассылку нельзя запустить заново: те, кому уже отправили, получили бы сообщение дважды. Чтобы повторить, сделайте копию и запустите её.

Право: broadcasts:write.

#tuktuk_list_broadcasts

Список рассылок с прогрессом: сколько отправлено, сколько не дошло.

Право: broadcasts:read.

#tuktuk_broadcast_report

Отчёт доставки по каждому получателю: кому ушло, кому нет и по какой причине.

Право: broadcasts:read.

#tuktuk_list_chains

Связки, это автоматические сценарии на входящее сообщение. Возвращает список с блоками и состоянием.

Право: chains:read.

Параметров нет.

#tuktuk_chain_block_types

Справочник типов блоков связки: что можно поставить в сценарий и ссылки на документацию.

Право: chains:read.

Параметров нет.

#tuktuk_chain_templates

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

Право: chains:read.

Параметров нет.

#tuktuk_create_chain_from_template

Создать связку из готового шаблона. Блоки, триггер и условия запуска приходят собранными; дальше её можно править через tuktuk_save_chain.

Право: chains:write.

#tuktuk_save_chain

Создать или изменить связку. Без chainId создаётся новая. Блоки передаются массивом целиком, типы берите из tuktuk_chain_block_types.

Право: chains:write.

#tuktuk_toggle_chain

Включить или выключить связку. Выключенная связка не запускается на входящие сообщения, но сохраняет схему и историю запусков.

Право: chains:write.

#tuktuk_list_funnels

Воронки автопостинга: сторис и посты по расписанию, в том числе зациклённые.

Право: funnels:read.

Параметров нет.

#tuktuk_run_funnel

Запустить или остановить воронку автопостинга. action=stop останавливает.

Право: funnels:write.

#tuktuk_list_assistants

ИИ-ассистенты рабочего пространства: кто отвечает клиентам автоматически, со статистикой.

Право: assistants:read.

Параметров нет.

#tuktuk_pause_assistant

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

Право: assistants:write.

#tuktuk_resume_assistant

Вернуть диалог ИИ-ассистенту раньше срока паузы: он снова начнёт отвечать клиенту.

Право: assistants:write.

#tuktuk_pause_all_assistants

Замолчать всем ассистентам на N минут: отвечать будут только люди. Настройки ассистентов сохраняются, по истечении срока они сами вернутся в работу.

Право: assistants:write.

#tuktuk_resume_all_assistants

Вернуть всех ассистентов в работу до истечения паузы.

Право: assistants:write.

Параметров нет.

#tuktuk_ai_catalog

Каталог нейросетей платформы: какие модели существуют, что умеют (текст, картинки, вызов функций), сколько примерно стоят и какие из них работают из России без VPN.

Право: ai:read.

Параметров нет.

#tuktuk_ai_providers

Нейросети, подключённые у клиента: модель по умолчанию, состояние ключа (работает / не принят) и список моделей, доступных именно по его ключу. Ключи наружу не отдаются.

Право: ai:read.

Параметров нет.

#tuktuk_ai_test_provider

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

Право: ai:write.

#tuktuk_ai_search_knowledge

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

Право: ai:read.

#tuktuk_ai_add_knowledge

Добавить в базу знаний файл, по которому будут отвечать ассистенты: прайс, условия доставки, ответы на частые вопросы. Текст режется на фрагменты и индексируется сразу.

Право: ai:write.

#tuktuk_ai_logs

Журнал обращений к нейросети: что спросил клиент, что ответил ассистент, какие действия он выполнил, сколько токенов ушло и с какой ошибкой всё упало. Первое место для разбора жалоб.

Право: ai:read.

#tuktuk_ai_chat

Разовый запрос к нейросети клиента, на его ключе и его тарифе. Полезно, когда нужно обработать текст в стиле компании, не заводя собственных ключей.

Право: ai:write.

#tuktuk_list_tasks

Задачи CRM: статус, приоритет, исполнитель, дедлайн, привязка к клиенту.

Право: tasks:read.

#tuktuk_create_task

Поставить задачу человеку. Используйте, когда сами решить вопрос не можете: нужен звонок, документ, решение руководителя.

Право: tasks:write.

#tuktuk_event_types

Каталог событий платформы, на которые можно подписаться: входящие сообщения, диалоги, связки, каналы, оплаты.

Право: webhooks:manage.

Параметров нет.

#tuktuk_subscribe_events

Подписаться на события: входящие сообщения и другие изменения будут приходить на ваш URL. Секрет подписи возвращается один раз, сохраните его: им подписан заголовок X-Webhook-Signature.

Право: webhooks:manage.

#tuktuk_list_subscriptions

Действующие подписки на события. Секреты не возвращаются.

Право: webhooks:manage.

Параметров нет.