mcp-telegram-agent
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_BOT_TOKEN | Yes | Your Telegram Bot Token obtained from @BotFather | |
| TELEGRAM_DEFAULT_CHAT_ID | Yes | Your unique numerical Telegram Chat ID, obtainable by sending any message to @userinfobot |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| send_text_messageC | Send text messages with Markdown/HTML formatting, silent mode, protection, inline buttons, or custom reply keyboards. 發送文字訊息。支援 Markdown 與 HTML 格式解析、靜音推播、內容保護、行內按鈕與底部鍵盤。 |
| send_chat_actionB | Broadcast ongoing bot status to the user (e.g., typing, uploading document, recording). 向使用者廣播機器人當前的操作狀態，如打字中、上傳檔案中等。 |
| send_local_documentC | Send any local file (code, reports, logs, zip, pdf) as a general document. 傳送本機任何檔案給使用者，涵蓋程式碼、日誌、PDF 與壓縮檔等。 |
| send_local_photoC | Send a local image file as a full-preview photo. 發送本機圖片檔案，以照片預覽格式呈現。 |
| send_local_videoC | Send a local video file (MP4, etc.) as a playable streaming video. 發送本機影片檔案，以內嵌播放器形式呈現，支援串流播放。 |
| send_local_audio_or_voiceB | Send a local audio file as a music track or a native voice note (OGG/Opus recommended). 發送本機音訊檔案：mode=audio 以音樂曲目呈現（可附標題與演出者）； mode=voice 以原生語音訊息呈現（建議使用 OGG/Opus 編碼）。 |
| send_media_albumC | Send 2 to 10 local photos or videos as a single grouped album (carousel). 批次發送 2 至 10 個本機圖片或影片，組合成輪播相簿。 |
| send_pollB | Send a poll or quiz card with clickable options. 發送投票或測驗卡片，供使用者點選。type=quiz 時可指定正確選項與解析說明。 |
| send_locationB | Send a geographic location card that opens directly in the map app. 發送地理位置卡片，可直接開啟地圖導航。 |
| send_contactC | Send a vCard contact so the user can save it to their address book. 發送名片聯絡人，可儲存至通訊錄。 |
| send_diceC | Send an animated random-value emoji (dice, dart, basketball, football, bowling, slot machine). 發送擲骰子等動態隨機結果的動畫元件。 |
| edit_message_textB | Edit the text or keyboard of a previously sent message (does not work for media albums). 編輯先前已發送的文字訊息內容或鍵盤佈局。 |
| delete_messageA | Delete a specific message by ID (can only delete messages sent by the bot). 刪除指定 ID 的訊息（僅能刪除機器人自己發送的訊息）。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool maps to a distinct Telegram content type (text, poll, location, contact, dice, album), so selection is mostly unambiguous. The only soft overlap is between send_local_document ('any local file') and the typed senders send_local_photo/video/audio, which an agent could plausibly confuse for a file that is also an image.
Nearly all tools follow a clean send_<object> snake_case pattern (send_text_message, send_poll, send_location), with edit_message_text and delete_message matching the same verb_noun convention. The send_local_* prefix groups file-based senders predictably, and the mode-based send_local_audio_or_voice is a readable, intentional deviation.
13 tools sit squarely in the well-scoped range for a messaging bot surface. Each tool earns its place by covering a distinct Telegram message type rather than duplicating functionality.
Outbound messaging is thoroughly covered: text, all media types, albums, polls, locations, contacts, dice, plus message edit and delete for lifecycle management. Obvious gaps remain around inbound/read operations (fetching or reading chat history), forwarding, and pinning, which would limit an agent working interactively with a conversation.