// MCP TOOL REFERENCE

MCP-TELEGRAM TOOLS

181 tools from the MCP-Telegram MCP Server, categorised by risk level.

View the MCP-Telegram policy →
// ALL 181 MCP-TELEGRAM TOOLS
READ 78 tools
Read telegram-download-media Download media from a Telegram message to a local file Read telegram-get-admin-log Get the admin action log (recent event history) of a supergroup or channel. Includes bans, edits, pins, and... Read telegram-get-all-stories Fetch active stories from contacts/channels the user follows. Pagination via Read telegram-get-available-star-gifts List all available Telegram Star Gifts that can be sent to other users. Returns gift ID, cost in Stars, con... Read telegram-get-boosts-list List the boosts applied to a channel/supergroup (premium.GetBoostsList). Returns paginated boost entries wi... Read telegram-get-boosts-status Fetch the boost status of a channel/supergroup (premium.GetBoostsStatus). Returns current boost level, tota... Read telegram-get-broadcast-stats Get broadcast channel statistics: followers, views/shares/reactions per post & story, notification percent,... Read telegram-get-business-chat-links List Telegram Business chat links configured for the account. Each entry includes the t.me/... link, the pr... Read telegram-get-channel-updates Fetch new messages and updates for a single channel/supergroup since a known per-channel pts cursor. Separa... Read telegram-get-chat-folders Get list of your Telegram chat folders (filters) with their names and chat counts Read telegram-get-chat-info Get detailed info about a Telegram chat including name, type, members, description, and forum status Read telegram-get-chat-members Get members of a Telegram group or channel Read telegram-get-contact-requests Get incoming messages from non-contacts (contact requests). Shows who messaged you without being in your co... Read telegram-get-contacts Get your Telegram contacts list with phone numbers Read telegram-get-discussion-message For a channel post with comments enabled, returns the linked discussion-group info: discussionGroupId, disc... Read telegram-get-drafts Get all saved message drafts across chats Read telegram-get-fact-check Get fact-check annotations on channel messages. Fact-checks are added by independent fact-checkers in suppo... Read telegram-get-global-privacy-settings Get your account-level global privacy settings: whether new non-contacts are auto-archived/muted, whether a... Read telegram-get-group-call Fetch metadata + an optional initial slice of participants for the active group call (voice/video chat) att... Read telegram-get-group-call-participants List participants of the active group call (voice/video chat) attached to a chat with pagination (phone.Get... Read telegram-get-groups-for-discussion List groups that can be linked as a discussion group to a channel you admin. Helper for channel admins sett... Read telegram-get-installed-stickers List all sticker sets installed by the user. Returns pack names and short names for use with other sticker ... Read telegram-get-invite-links Get list of invite links for a group or channel. By default returns links created by the current account; p... Read telegram-get-megagroup-stats Get supergroup statistics: members, messages, viewers, posters (current vs previous period), top posters/ad... Read telegram-get-message-buttons List the inline/reply keyboard buttons on a Telegram message with their (row, col) indices, type (e.g. Keyb... Read telegram-get-message-link Get a t.me link to a specific message in a Telegram channel or supergroup Read telegram-get-message-read-participants List who has read a message in a small group (≤100 members, ≤7 days old). Returns readers with userId, read... Read telegram-get-my-boosts List the user Read telegram-get-my-role Get the current user Read telegram-get-outbox-read-date Get when your recipient read your outgoing message in a private chat. Returns null/Not read yet if unread. ... Read telegram-get-paid-reaction-privacy Get your current default paid reaction privacy setting. Read telegram-get-peer-stories Fetch currently active stories posted by a specific peer (user/channel). Returns compact story metadata (id... Read telegram-get-poll-results Get aggregated poll results: vote counts, percentages, quiz answer status Read telegram-get-poll-voters List users who voted for specific poll options (public polls only, paginated) Read telegram-get-profile Get detailed profile info of a Telegram user including bio, birthday, premium status, business info and more Read telegram-get-profile-photo Download profile photo of a Telegram user, group, or channel. Returns inline image or saves to file Read telegram-get-quick-replies Fetch the list of quick-reply shortcuts configured for the user account (messages.GetQuickReplies). Each en... Read telegram-get-quick-reply-messages Fetch messages stored under a quick-reply shortcut (messages.GetQuickReplyMessages). Use Read telegram-get-reactions Get detailed reaction info for a message: which reactions, counts, and who reacted (when visible) Read telegram-get-recent-reactions Get the list of emoji reactions the current account used recently Read telegram-get-recent-stickers Get recently used stickers. Returns each sticker with its list index and associated emoji Read telegram-get-replies Get replies/comments under a Telegram channel post or discussion message Read telegram-get-saved-dialogs Get Saved Messages dialogs (Telegram Read telegram-get-saved-star-gifts List Star Gifts received by a user or chat. Pass Read telegram-get-scheduled List scheduled messages in a Telegram chat Read telegram-get-sessions Get list of all active Telegram sessions (logged-in devices) with device info, IP, and last active time Read telegram-get-stars-status Fetch the current Telegram Stars balance and recent activity for a peer (payments.GetStarsStatus). Pass Read telegram-get-stars-subscriptions List active Telegram Stars subscriptions for a peer (payments.GetStarsSubscriptions). Pass Read telegram-get-stars-topup-options List available Telegram Stars top-up tiers (from payments.GetStarsTopupOptions). Returns each option with s... Read telegram-get-stars-transactions Fetch a paginated Telegram Stars transaction history for a peer (payments.GetStarsTransactions). Pass Read telegram-get-state Initialize the polling cursor by fetching the current Telegram updates state {pts, qts, date, seq, unreadCo... Read telegram-get-sticker-set Get all stickers from a sticker set by its short name. Returns each sticker with index and emoji. Use the i... Read telegram-get-stories-archive Fetch auto-archived (expired) stories from a peer Read telegram-get-stories-by-id Fetch specific stories from a peer by their numeric IDs. Useful for retrieving archived/pinned stories outs... Read telegram-get-story-views List viewers of one of YOUR stories (stories.GetStoryViewsList). Returns per-viewer entries (user id, view ... Read telegram-get-suggested-folders Get Telegram Read telegram-get-top-reactions Get the list of most popular emoji reactions available on Telegram Read telegram-get-transcription Poll for updated transcription result. Calls the same endpoint as telegram-transcribe-audio — Telegram guar... Read telegram-get-unread Get chats with unread messages. Forums show per-topic unread breakdown Read telegram-get-unread-mentions Get unread @mentions addressed to you in a Telegram chat. Marks all mentions as read on the server when all... Read telegram-get-unread-reactions Get messages with unread reactions on your posts in a Telegram chat. Marks all reactions as read on the ser... Read telegram-get-updates Fetch new messages, deleted messages, and other updates since a previously-known {pts, qts, date} cursor (f... Read telegram-get-web-preview Fetch Telegram Read telegram-inline-query Query an inline bot (like @gif, @bing) in a chat context and return the compact result list. Returns queryI... Read telegram-list-chats List Telegram chats with unread counts, type indicators, and contact status Read telegram-list-emoji-statuses List default or recently-used emoji statuses available for your account. Useful for finding a documentId to... Read telegram-list-topics List forum topics in a Telegram group with Topics enabled. Shows topic names, unread counts, and status Read telegram-read-messages Read recent messages from a Telegram chat with sender names, dates, media info, and reactions Read telegram-read-topic-messages Read messages from a specific forum topic in a Telegram group Read telegram-search-chats Search for Telegram chats, users, or channels by name or username. Returns description and member count Read telegram-search-global Search messages globally across all public Telegram chats and channels Read telegram-search-messages Search messages in a specific Telegram chat by text Read telegram-search-sticker-sets Search for sticker sets by name or keyword. Returns matching sticker pack names that can be used with teleg... Read telegram-status Check Telegram connection status Read telegram-transcribe-audio Request server-side transcription of a voice note or video note (Telegram Premium feature). Returns immedia... Read telegram-translate-message Translate one or more Telegram messages to a target language (requires Telegram Premium). Consumes account ... Read telegram-export-story-link Get a shareable t.me/… URL for a public story. Read telegram-resolve-business-chat-link Resolve a Telegram Business chat link by slug to see whose chat it opens and the pre-filled message. Return...
WRITE 79 tools
Write telegram-react-to-story React to a story with an emoji, or remove the current reaction by passing Write telegram-remove-admin Remove admin rights from a user in a supergroup or channel Write telegram-toggle-story-pinned-to-top Pin stories to the very top of your pinned row. Pass an empty array [] to clear all top-pinned stories. Write telegram-forward-message Forward messages between Telegram chats Write telegram-inline-query-send Send an inline bot result to a chat by queryId + resultId (as returned by telegram-inline-query). The query... Write telegram-join-chat Join a Telegram group or channel by username or invite link Write telegram-rate-transcription Rate transcription quality (good/poor) to improve Telegram speech-to-text. Write telegram-read-stories Mark stories as seen up to a given story ID (maxId, inclusive). Write telegram-reorder-folders Reorder Telegram chat folders by specifying a new order of folder IDs. All existing custom folder IDs must ... Write telegram-report-spam Report a chat as spam to Telegram Write telegram-toggle-channel-signatures Enable or disable author signatures on broadcast channel posts. Channel admin required; not supported for s... Write telegram-toggle-folder-tags Enable or disable folder tags (colored labels that appear on messages in chat lists when the message belong... Write telegram-toggle-forum-mode Enable or disable forum/topics mode in a supergroup. Supergroup only; requires creator or admin. Write telegram-toggle-paid-reaction-privacy Change leaderboard visibility of your paid reaction on a specific channel post (Layer 198 API). Write telegram-toggle-prehistory-hidden Toggle pre-history visibility for new members in a supergroup. When hidden=true, new joiners cannot see mes... Write telegram-toggle-story-pinned Pin or unpin stories in your profile highlights (Telegram allows up to 3 pinned stories). Write telegram-unban-user Unban a previously banned user from a supergroup or channel Write telegram-unblock-user Unblock a previously blocked Telegram user Write telegram-unpin-message Unpin a message in a Telegram chat Write telegram-activate-stealth-mode Hide your story views retroactively (past=true) and/or for the next 25 minutes (future=true). Requires Tele... Write telegram-add-contact Add a user to your Telegram contacts. Use this to accept contact requests from non-contacts Write telegram-approve-join-request Approve or deny a pending join request for a supergroup or channel (basic groups are not supported). Admin ... Write telegram-archive-chat Archive or unarchive a Telegram dialog (moves to/from the Archive folder) Write telegram-block-user Block a Telegram user. Blocked users cannot send you messages Write telegram-create-business-chat-link Create a Telegram Business chat link (t.me/m/... deep-link that opens a chat with you pre-filled with a mes... Write telegram-create-folder Create a new Telegram chat folder (filter). Returns the new folder ID. Pass type flags to auto-include enti... Write telegram-create-group Create a new Telegram group or supergroup Write telegram-create-invite-link Create a new invite link for a group or channel Write telegram-create-poll Create a poll in a Telegram chat (multiple choice or quiz mode) Write telegram-create-topic Create a new forum topic in a forum-enabled supergroup Write telegram-edit-business-chat-link Edit an existing Telegram Business chat link by its slug (the trailing segment after t.me/m/). Returns JSON... Write telegram-edit-fact-check Add or update a fact-check annotation. Requires fact-checker privileges (limited to independent verifiers i... Write telegram-edit-folder Edit an existing Telegram chat folder by its ID (from telegram-get-chat-folders). Only pass fields you want... Write telegram-edit-group Edit a group Write telegram-edit-message Edit a previously sent message in Telegram Write telegram-edit-story Edit an existing story: replace media, update caption ( Write telegram-edit-topic Edit a forum topic — rename, change icon emoji, open/close, or show/hide Write telegram-invite-to-group Invite users to a Telegram group or channel Write telegram-mark-as-read Mark a Telegram chat as read Write telegram-mark-dialog-unread Mark a Telegram dialog as unread (or clear the unread mark) Write telegram-mute-chat Mute or unmute notifications for a Telegram chat. Set muted=true to mute (optionally with duration in secon... Write telegram-pin-chat Pin or unpin a Telegram dialog in the dialog list Write telegram-pin-message Pin a message in a Telegram chat Write telegram-save-draft Save or clear a message draft for a chat. Pass empty text to clear the draft. Optional replyTo sets the mes... Write telegram-save-star-gift Show or hide a received Star Gift on your profile. Pass msgId for a gift received as a personal message (DM... Write telegram-send-album Send an album (group) of 2-10 photos as a single grouped message. Media type is auto-detected Write telegram-send-contact Send a contact card (phone number + name) to a Telegram chat. Write telegram-send-dice Send an animated dice/game emoji to a Telegram chat. Returns the server-rolled value — useful for games, Write telegram-send-file Send a file (photo, document, video, etc.) to a Telegram chat Write telegram-send-location Send a geographic location to a Telegram chat. Static pin by default; set livePeriod to share a live-updati... Write telegram-send-message Send a message to a Telegram chat Write telegram-send-reaction Send emoji reaction(s) to a message. Supports multiple reactions and adding to existing ones. Omit emoji to... Write telegram-send-scheduled Send a scheduled message to a Telegram chat. The message will be delivered at the specified time by Telegra... Write telegram-send-sticker Send a sticker from a sticker set to a chat. First use telegram-get-sticker-set to browse available sticker... Write telegram-send-story Publish a new story (photo or video) to your profile or a channel you manage. Privacy: everyone/contacts/cl... Write telegram-send-typing Send a typing/upload indicator to a Telegram chat (or cancel it) Write telegram-send-venue Send a venue card (point-of-interest with title and address) to a Telegram chat. Write telegram-send-video-note Send a video note (round-shaped short video) to a Telegram chat. Shows as a circular video in the UI. Write telegram-send-voice Send a voice note (audio recording) to a Telegram chat. Shows as a voice message with waveform UI. Write telegram-set-admin Promote a user to admin in a supergroup or channel with full permissions Write telegram-set-auto-delete Set auto-delete timer for messages in a chat. Common values: 86400 (1 day), 604800 (1 week), 2592000 (1 mon... Write telegram-set-birthday Set your birthday in your Telegram profile. Year is optional (omit to hide age). Pass clear=true to remove ... Write telegram-set-business-away Set Telegram Business away message — auto-reply when you are offline or outside work hours. Uses a quick re... Write telegram-set-business-greeting Set Telegram Business greeting message — auto-reply sent to new conversations using a quick reply shortcut ... Write telegram-set-business-hours Set Telegram Business work hours — days and time ranges when your business is open. Requires Telegram Busin... Write telegram-set-business-intro Set Telegram Business intro card — title and description shown to new users opening your chat, with an opti... Write telegram-set-business-location Set Telegram Business physical location (address + optional geo coordinates). Requires Telegram Business su... Write telegram-set-chat-permissions Set the default permissions for all non-admin members of a group, supergroup, or channel. Omitted flags kee... Write telegram-set-chat-reactions Set which reactions are available in a chat. type= Write telegram-set-default-reaction Set the default emoji reaction used in quick-reaction menus across Telegram Write telegram-set-emoji-status Set your profile emoji status (custom animated emoji shown next to your name). Requires Telegram Premium. P... Write telegram-set-global-privacy-settings Update account-level global privacy settings. Only pass the fields you want to change — omitted fields keep... Write telegram-set-personal-channel Set the channel displayed on your profile as Write telegram-set-privacy Configure privacy settings for your Telegram account. Controls who can see your phone number, last seen, pr... Write telegram-set-profile-color Set your profile name color or profile background color. Requires Telegram Premium for colors above index 6... Write telegram-set-profile-photo Upload and set a new profile photo from a local file. Supports JPEG/PNG for static avatar or MP4 for animat... Write telegram-set-slow-mode Set slow mode for a supergroup (minimum interval between messages per user). Allowed values: 0, 10, 30, 60,... Write telegram-update-profile Update your Telegram profile — first name, last name, bio, or username Write telegram-vote-poll Vote in a poll by option index (single or multi-choice). Empty array retracts vote.
DESTRUCTIVE 17 tools
Destructive telegram-clear-drafts Delete saved message drafts. Pass chatId to clear the draft for a single chat. Without chatId, clears draft... Destructive telegram-clear-recent-emoji-statuses Clear your recently-used emoji status list (the Destructive telegram-close-poll Close a poll permanently. This is a one-way operation — closed polls cannot be reopened. Destructive telegram-delete-business-chat-link Delete a Telegram Business chat link by its slug. Requires Telegram Business subscription. Destructive telegram-delete-fact-check Remove a fact-check annotation. Requires fact-checker privileges. Destructive telegram-delete-folder Delete a Telegram chat folder by its ID. Chats inside the folder are not deleted — they remain in All Chats... Destructive telegram-delete-message Delete messages in a Telegram chat Destructive telegram-delete-profile-photo Delete one or more profile photos by their photo IDs. Use telegram-get-profile-photo to obtain the current ... Destructive telegram-delete-scheduled Delete scheduled messages in a Telegram chat Destructive telegram-delete-stories Delete one or more of your own stories. This action is irreversible and requires confirm:true. Destructive telegram-delete-topic Delete a forum topic and all its message history Destructive telegram-revoke-invite-link Revoke an invite link for a group or channel Destructive telegram-logout Log out from Telegram completely. Revokes the session on Telegram servers (removes it from Settings → Devic... Destructive telegram-ban-user Ban a user from a supergroup or channel (permanent until unbanned) Destructive telegram-kick-user Kick a user from a Telegram group (removes without permanent ban) Destructive telegram-leave-group Leave a Telegram group or channel Destructive telegram-terminate-session Terminate a specific Telegram session by its hash, or explicitly terminate all other sessions by setting te...
EXECUTE 4 tools
Execute telegram-report-story Report a story via the multi-step option flow. First call with option: Execute telegram-toggle-anti-spam Enable or disable aggressive anti-spam filtering in a supergroup. Supergroup only (not broadcast channels);... Execute telegram-login Login to Telegram via QR code. Returns QR image. IMPORTANT: pass the entire result to user without modifica... Execute telegram-press-button Press an inline keyboard callback button on a message. Identify the button by (row, column) from its replyM...
FINANCIAL 3 tools
Financial telegram-change-stars-subscription Cancel or restore a Telegram Stars subscription (payments.ChangeStarsSubscription). Pass canceled=true to c... Financial telegram-convert-star-gift Convert a received Star Gift into Stars (non-reversible). The gift is removed from your profile and its con... Financial telegram-send-paid-reaction Send a paid reaction (★ Stars) on a channel post. Stars are spent from your balance. Optional private flag ...

Route MCP-Telegram through PolicyLayer and every one of its 181 tools is checked against your policy before it runs.

CHECK YOUR STACK →

See every tool, the dangerous ones, and the token cost across your stack.

// FAQ
How many tools does the MCP-Telegram MCP server have? +

The MCP-Telegram MCP server exposes 181 tools across 5 categories: Read, Write, Destructive, Execute, Financial.

How do I enforce policies on MCP-Telegram tools? +

Route the MCP-Telegram server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do MCP-Telegram tools fall into? +

MCP-Telegram tools are categorised as Read (78), Write (79), Destructive (17), Execute (4), Financial (3). Each category has a recommended default policy.

Enforce policy on every MCP-Telegram tool call.

Start from MCP-Telegram, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.