Tools Reference
MCP Telegram provides 59 tools organized by category. All tools are auto-discoverable — your AI client will see them with full parameter descriptions when connected.
Auth (2)
| Tool | Description |
|---|---|
telegram-status | Check connection status and get account info |
telegram-login | Generate QR code for authentication |
Messaging (5)
| Tool | Description |
|---|---|
telegram-send-message | Send a message to any chat (user, group, channel) |
telegram-edit-message | Edit a previously sent message |
telegram-delete-message | Delete one or more messages |
telegram-forward-message | Forward messages between chats |
telegram-send-scheduled | Schedule a message for later delivery |
Reading (7)
| Tool | Description |
|---|---|
telegram-list-chats | List your chats with filters (users, groups, channels) |
telegram-read-messages | Read recent messages from a chat with pagination |
telegram-search-messages | Search messages in a specific chat by keyword |
telegram-search-global | Search messages across all chats at once |
telegram-search-chats | Find chats by name or description |
telegram-get-unread | Get all chats with unread messages and counts |
telegram-mark-as-read | Mark a chat as read |
Forum Topics (2)
| Tool | Description |
|---|---|
telegram-list-topics | List topics in a forum group |
telegram-read-topic-messages | Read messages from a specific topic |
Polls (1)
| Tool | Description |
|---|---|
telegram-create-poll | Create a poll or quiz in a chat |
Reactions (2)
| Tool | Description |
|---|---|
telegram-send-reaction | React to a message with an emoji |
telegram-get-reactions | Get reactions on a message |
Stickers (5)
| Tool | Description |
|---|---|
telegram-send-sticker | Send a sticker to a chat |
telegram-get-installed-stickers | List your installed sticker packs |
telegram-get-recent-stickers | Show recently used stickers |
telegram-get-sticker-set | Browse stickers in a specific pack |
telegram-search-sticker-sets | Search Telegram's sticker catalog |
Media (3)
| Tool | Description |
|---|---|
telegram-send-file | Send a file, photo, or document |
telegram-download-media | Download media from a message |
telegram-get-profile-photo | Get a user's or chat's profile photo |
Groups (11)
| Tool | Description |
|---|---|
telegram-create-group | Create a new group |
telegram-edit-group | Edit group title, description, or photo |
telegram-invite-to-group | Invite users to a group |
telegram-join-chat | Join a group or channel via invite link |
telegram-leave-group | Leave a group or channel |
telegram-kick-user | Remove a user from a group |
telegram-ban-user | Ban a user from a group |
telegram-unban-user | Unban a user |
telegram-set-admin | Promote a user to admin with custom permissions |
telegram-remove-admin | Remove admin rights from a user |
telegram-get-my-role | Check your role and permissions in a group |
Chat Info (3)
| Tool | Description |
|---|---|
telegram-get-chat-info | Get detailed chat info (title, members, photo, etc.) |
telegram-get-chat-members | List members of a group or channel |
telegram-get-chat-folders | List your chat folders |
Invite Links (3)
| Tool | Description |
|---|---|
telegram-create-invite-link | Create an invite link with optional limits |
telegram-get-invite-links | List existing invite links |
telegram-revoke-invite-link | Revoke an invite link |
Contacts (3)
| Tool | Description |
|---|---|
telegram-get-contacts | List your contacts |
telegram-add-contact | Add a new contact |
telegram-get-contact-requests | View pending contact requests |
Moderation (3)
| Tool | Description |
|---|---|
telegram-block-user | Block a user |
telegram-unblock-user | Unblock a user |
telegram-report-spam | Report spam |
Profiles (2)
| Tool | Description |
|---|---|
telegram-get-profile | Get a user's profile info |
telegram-update-profile | Update your own profile (name, bio, username) |
Account (4)
| Tool | Description |
|---|---|
telegram-get-sessions | List active sessions (devices) |
telegram-terminate-session | Terminate a session |
telegram-set-privacy | Configure privacy settings (phone, last seen, etc.) |
telegram-set-auto-delete | Set auto-delete timer for a chat |
Pinning (2)
| Tool | Description |
|---|---|
telegram-pin-message | Pin a message in a chat |
telegram-unpin-message | Unpin a message or all messages |
Chat Settings (1)
| Tool | Description |
|---|---|
telegram-mute-chat | Mute or unmute chat notifications |
TIP
You don't need to memorize these tools. Just describe what you want in natural language — your AI assistant will pick the right tool automatically.