1-чат
TelegramTelegram

MCP-сервер для Telegram

Пользовательский аккаунт вместо бота: полный набор инструментов без ограничений Bot API.

Получить API-ключGitHub
01

Почему не Bot API

Bot API запрещает инициировать диалог: пока пользователь не отправил /start, любая попытка отправки возвращает ошибку. 1-чат работает через пользовательский аккаунт, поэтому start_chat принимает телефон в формате E.164 или юзернейм и открывает диалог сразу. Сообщение приходит от вашего аккаунта, а не от бота.

02

Доступные операции

Чтение истории без ограничения по глубине, отправка текста и ответов на конкретное сообщение (reply_to), изображения и документы до 25 МБ, групповые чаты, реакции, mark_read. Голосовые возвращаются расшифровкой через transcribe_voice — обрабатывать аудио на своей стороне не нужно.

03

Входящие

subscribe_events регистрирует webhook, на который приходит POST с событием message.received. Опрос через list_chats тоже поддерживается, но расходует общий лимит в 60 запросов в минуту.

start_chat · telegram
{
  "tool": "start_chat",
  "arguments": {
    "channel": "telegram",
    "to": "@ivan_petrov",
    "text": "Иван, расчёт готов — отправляю файлом."
  }
}

Инструменты

start_chat(channel: Channel, to: string, text: string)→ Chat
Первое сообщение контакту, с которым переписки не было. to — телефон в E.164 или юзернейм.
send_message(chat_id: string, text: string, reply_to?: string)→ Message
Отправка в существующий диалог. reply_to делает сообщение ответом на конкретное входящее.
get_messages(chat_id: string, limit?: number, before?: string)→ Message[]
История диалога в обратном хронологическом порядке. before — id сообщения для пагинации вглубь.
transcribe_voice(message_id: string)→ { text, duration }
Расшифровка голосового в текст. Русский и английский, автоопределение языка.
subscribe_events(webhook_url: string, channels?: Channel[], events?: EventType[])→ Subscription
Подписка на входящие. Без параметров — все события всех подключённых каналов.
Полный справочник

Частые вопросы

Остальное в разделе

Подключите агента к мессенджерам

Выпустите ключ, добавьте пять строк в конфиг — и агент начнёт писать клиентам сам.

Получить API-ключКонфиг на GitHub

Есть вопросы? Напишите нам в Telegram →