---
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
