telegram

name	telegram
description	Interact with Telegram — send messages, photos, documents, locations, edit and delete messages, get chat and member info. Use when the user asks to send a Telegram message, edit content, send media, or manage Telegram chats.
emoji	📱

Telegram

Interact with Telegram using the built-in MCP tools provided by the nomos-telegram server. These tools call the Telegram Bot API directly — no curl commands or shell environment variables needed.

Available Tools

Messaging

Tool	Description
telegram_send_message	Send a text message (supports Markdown and HTML formatting)
telegram_edit_message	Edit an existing message
telegram_delete_message	Delete a message

Media

Tool	Description
telegram_send_photo	Send a photo from URL or local file (with optional caption)
telegram_send_document	Send a document/file from URL or local file
telegram_send_location	Send a geographic location

Info

Tool	Description
telegram_chat_info	Get details about a chat (type, title, username, description)
telegram_member_info	Get details about a chat member (status, username)
telegram_bot_info	Get information about the bot itself

Utility

Tool	Description
telegram_send_typing	Send a typing indicator (shows "typing..." in the chat)

Usage Examples

Send a message

Use telegram_send_message with a chat ID and text. Optionally set parse_mode to "Markdown" or "HTML" for formatting.

Reply to a message

Use telegram_send_message with reply_to_message_id set to the original message ID.

Send a formatted message

Markdown mode:

• *bold*, _italic_, `code`, ```code block```
• [link text](url)

HTML mode:

• <b>bold</b>, <i>italic</i>, <code>code</code>, <pre>code block</pre>
• <a href="url">link text</a>

Send a photo

Use telegram_send_photo with a URL or local file path. Add a caption (max 1024 chars).

Send a document

Use telegram_send_document with a URL or local file path.

Get chat info

Use telegram_chat_info with a chat ID to see the chat type, title, and description.

Tips

• Chat IDs: positive = users, negative = groups/channels
• Message IDs: unique within a chat (integers, not timestamps)
• Message length limit: 4096 characters per message
• Photo captions: max 1024 characters
• File size limits: photos 10MB, documents 50MB
• Formatting: set parse_mode to "Markdown" or "HTML" — if omitted, no formatting is applied
• Groups: bots only see messages that mention them unless privacy mode is disabled
• Rate limits: ~30 msg/sec globally, ~1 msg/sec per chat. The tools handle errors automatically.
• Bot management: use @BotFather on Telegram to create and configure bots