MCP-Telegram

181 tools. 103 can modify or destroy data without limits.

20 destructive tools with no built-in limits. Policy required.

Last updated:

103 can modify or destroy data
78 read-only
181 tools total

Community server · catalogue entry verified 12/06/2026

How to control MCP-Telegram ↓

What MCP-Telegram exposes to your agents

Read (78) Write / Execute (83) Destructive / Financial (20)
Critical Risk

The most dangerous MCP-Telegram tools

103 of MCP-Telegram's 181 tools can modify, destroy, or commit something on every call — and an agent calls them with no built-in limits.

How to control MCP-Telegram

PolicyLayer is an MCP gateway — it sits between your AI agents and MCP-Telegram, and nothing reaches the server without passing your rules. These are the rules we recommend:

Block financial tools by default
{
  "telegram-change-stars-subscription": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Requires human approval."
      }
    ]
  }
}

Financial tools should be explicitly enabled per use case, not open by default.

Deny destructive operations
{
  "telegram-clear-drafts": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations
{
  "telegram-react-to-story": {
    "limits": [
      {
        "counter": "telegram-react-to-story_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations
{
  "telegram-download-media": {
    "limits": [
      {
        "counter": "telegram-download-media_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

  1. Create a free account and register MCP-Telegram — nothing to install.
  2. Add these rules — paste them, or build them visually. Tune the limits to your setup.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
ENFORCE POLICY ON MCP-TELEGRAM →

Free to start. No card required.

All 181 MCP-Telegram tools

DESTRUCTIVE 17 tools
Destructive telegram-clear-drafts Delete saved message drafts. Pass chatId to clear the draft for a single chat. Without chatId, clears drafts i 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. S 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 pho 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 → Devices) 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 termi
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 queryId 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 be 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 supe Write telegram-toggle-folder-tags Enable or disable folder tags (colored labels that appear on messages in chat lists when the message belongs t 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 messag 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 Telegra 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 wit 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 messag Write telegram-create-folder Create a new Telegram chat folder (filter). Returns the new folder ID. Pass type flags to auto-include entire 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 wi Write telegram-edit-fact-check Add or update a fact-check annotation. Requires fact-checker privileges (limited to independent verifiers in s Write telegram-edit-folder Edit an existing Telegram chat folder by its ID (from telegram-get-chat-folders). Only pass fields you want to 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 seconds) 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 messag 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-updating 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 re Write telegram-send-scheduled Send a scheduled message to a Telegram chat. The message will be delivered at the specified time by Telegram s Write telegram-send-sticker Send a sticker from a sticker set to a chat. First use telegram-get-sticker-set to browse available stickers a Write telegram-send-story Publish a new story (photo or video) to your profile or a channel you manage. Privacy: everyone/contacts/close 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 month) Write telegram-set-birthday Set your birthday in your Telegram profile. Year is optional (omit to hide age). Pass clear=true to remove bir Write telegram-set-business-away Set Telegram Business away message — auto-reply when you are offline or outside work hours. Uses a quick reply Write telegram-set-business-greeting Set Telegram Business greeting message — auto-reply sent to new conversations using a quick reply shortcut as Write telegram-set-business-hours Set Telegram Business work hours — days and time ranges when your business is open. Requires Telegram Business Write telegram-set-business-intro Set Telegram Business intro card — title and description shown to new users opening your chat, with an optiona Write telegram-set-business-location Set Telegram Business physical location (address + optional geo coordinates). Requires Telegram Business subsc Write telegram-set-chat-permissions Set the default permissions for all non-admin members of a group, supergroup, or channel. Omitted flags keep t 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. Pass Write telegram-set-global-privacy-settings Update account-level global privacy settings. Only pass the fields you want to change — omitted fields keep th 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, profi Write telegram-set-profile-color Set your profile name color or profile background color. Requires Telegram Premium for colors above index 6 an 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 animated Write telegram-set-slow-mode Set slow mode for a supergroup (minimum interval between messages per user). Allowed values: 0, 10, 30, 60, 30 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.
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 ro 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, conver Read telegram-get-boosts-list List the boosts applied to a channel/supergroup (premium.GetBoostsList). Returns paginated boost entries with Read telegram-get-boosts-status Fetch the boost status of a channel/supergroup (premium.GetBoostsStatus). Returns current boost level, total b Read telegram-get-broadcast-stats Get broadcast channel statistics: followers, views/shares/reactions per post & story, notification percent, re Read telegram-get-business-chat-links List Telegram Business chat links configured for the account. Each entry includes the t.me/... link, the prefi Read telegram-get-channel-updates Fetch new messages and updates for a single channel/supergroup since a known per-channel pts cursor. Separate 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 conta 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, discuss 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 supporte Read telegram-get-global-privacy-settings Get your account-level global privacy settings: whether new non-contacts are auto-archived/muted, whether arch Read telegram-get-group-call Fetch metadata + an optional initial slice of participants for the active group call (voice/video chat) attach Read telegram-get-group-call-participants List participants of the active group call (voice/video chat) attached to a chat with pagination (phone.GetGro 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 setting Read telegram-get-installed-stickers List all sticker sets installed by the user. Returns pack names and short names for use with other sticker too Read telegram-get-invite-links Get list of invite links for a group or channel. By default returns links created by the current account; pass Read telegram-get-megagroup-stats Get supergroup statistics: members, messages, viewers, posters (current vs previous period), top posters/admin Read telegram-get-message-buttons List the inline/reply keyboard buttons on a Telegram message with their (row, col) indices, type (e.g. Keyboar 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, readAt 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. Err 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, d 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 entry 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 star 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, unreadCount 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 inde 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 outside Read telegram-get-story-views List viewers of one of YOUR stories (stories.GetStoryViewsList). Returns per-viewer entries (user id, view dat 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 guarant 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 un Read telegram-get-unread-reactions Get messages with unread reactions on your posts in a Telegram chat. Marks all reactions as read on the server Read telegram-get-updates Fetch new messages, deleted messages, and other updates since a previously-known {pts, qts, date} cursor (from 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 queryId, 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 pa 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 telegram 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 immediatel Read telegram-translate-message Translate one or more Telegram messages to a target language (requires Telegram Premium). Consumes account tra 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. Returns J

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

Questions about MCP-Telegram

Can an AI agent move money through the MCP-Telegram MCP server? +

Yes. The MCP-Telegram server exposes 3 financial tools including telegram-change-stars-subscription, telegram-convert-star-gift, telegram-send-paid-reaction. Without a policy, an autonomous agent can call these with no spend caps, no rate limits, and no approval flow. PolicyLayer lets you block financial tools by default, require human approval, or set per-tool rate limits — enforced on every call.

Can an AI agent delete data through the MCP-Telegram MCP server? +

Yes. The MCP-Telegram server exposes 17 destructive tools including telegram-clear-drafts, telegram-clear-recent-emoji-statuses, telegram-close-poll. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through MCP-Telegram? +

The MCP-Telegram server has 79 write tools including telegram-react-to-story, telegram-remove-admin, telegram-toggle-story-pinned-to-top. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach MCP-Telegram.

How many tools does the MCP-Telegram MCP server expose? +

181 tools across 4 categories: Destructive, Execute, Read, Write. 78 are read-only. 103 can modify, create, or delete data.

How do I enforce a policy on MCP-Telegram? +

Register the MCP-Telegram MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

Enforce policy on every MCP-Telegram tool call.

Deterministic rules across all 181 MCP-Telegram tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

Free to start. No card required.

181 MCP-Telegram tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.