mcp-telegram mcp

v1.5.0 · MCP Tool · communication · registry.pascalai.org

Send Telegram messages, media and files via Bot API. token is optional if TELEGRAM_BOT_TOKEN env var is set. Operations: me (no params), send (chatId+text), photo (chatId+path or photoUrl), audio/video/document (chatId+path), file (chatId+path, auto-detects type), updates (limit/offset), delete (chatId+messageId).

telegrammessagingbotnotificationschatsendalertscommunicationphotoaudiovideodocument

Input Parameters

ParameterTypeDescription
operationrequired string Operation to perform. Required params per operation: me=none; send=chatId+text (parseMode optional, default HTML); photo=chatId + path (local file) or photoUrl (remote URL/file_id), caption optional; audio=chatId+path, caption optional; video=chatId+path, caption optional; document=chatId+path, caption optional; file=chatId+path, caption optional (auto-detects photo/audio/video/document by extension); updates=limit optional (default 10 max 100), offset optional; delete=chatId+messageId. One of: me, send, photo, audio, video, document, file, updates, delete.
tokenoptional string Bot token from @BotFather (e.g. '123456:ABC-DEF...'). OPTIONAL: omit or pass empty string to use TELEGRAM_BOT_TOKEN env var instead.
chatIdoptional string Target chat or user ID (required for send, photo, audio, video, document, file, delete). E.g. '987654321', '-1001234567890', '@channelname'.
textoptional string Message text for 'send' operation. Supports HTML and Markdown.
parseModeoptional string Text parse mode for 'send'. Default: HTML. One of: HTML, Markdown, MarkdownV2, . Default: HTML.
pathoptional string Local file path for photo, audio, video, document or file operations (e.g. 'C:\Users\user\image.png' or '/home/user/file.pdf').
photoUrloptional string Public URL or file_id for 'photo' operation when sending a remote image instead of a local file.
captionoptional string Caption text for photo, audio, video, document or file.
messageIdoptional integer Message ID — required for 'delete' operation.
limitoptional integer Max number of updates to fetch for 'updates' operation. Default: 10, max: 100. Default: 10.
offsetoptional integer Update offset for 'updates' pagination — marks prior updates as read.

Output Fields

FieldTypeDescription
ok boolean
message_id integer
chat_id string
text string
file string
type string
count integer
updates array[object]

Examples

Send a text message to a user

// Input
{
  "operation": "send",
  "token": "123456:ABC...",
  "chatId": "987654321",
  "text": "<b>Hola!</b> Este mensaje viene del bot.",
  "parseMode": "HTML"
}

// Output
{
  "ok": true,
  "message_id": 4521,
  "chat_id": "987654321"
}

Send a local image file as photo

// Input
{
  "operation": "photo",
  "token": "123456:ABC...",
  "chatId": "987654321",
  "path": "C:\\Users\\user\\pictures\\AbejitaMuyTierna.png",
  "caption": "Que ternura!"
}

// Output
{
  "ok": true,
  "message_id": 4522,
  "chat_id": "987654321"
}

Auto-detect type and send any local file

// Input
{
  "operation": "file",
  "token": "123456:ABC...",
  "chatId": "987654321",
  "path": "C:\\Users\\user\\report.pdf",
  "caption": "Reporte mensual"
}

// Output
{
  "ok": true,
  "message_id": 4523,
  "type": "document"
}

Get recent incoming messages

// Input
{
  "operation": "updates",
  "token": "123456:ABC...",
  "limit": 5
}

// Output
{
  "count": 2,
  "updates": []
}

Install & Discovery

Install

ppm install mcp-telegram

Get JSON Schema

GET /v1/packages/mcp-telegram/1.5.0/schema

Discover by keyword

GET /v1/mcp/discover?q=telegram
Discovery hint: Install with ppm install mcp-telegram or invoke remotely via POST /v1/invoke/mcp-telegram on the MCP Service.