Provides tools for interacting with a real Telegram user account via MTProto, enabling reading, searching, sending, editing, forwarding, reacting, polling, moderating, managing contacts, stories, drafts, notifications, folders, privacy, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-telegram send 'hi' to my engineering channel"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server that connects Claude Desktop, Codex CLI, Cursor, Claude Code, VS Code, Cline, Windsurf, Goose, and any other MCP-compatible client to a real Telegram user account via MTProto—so your agent can read, search, send, moderate, and manage Telegram chats from chat or automated tool calls instead of clicking through the Telegram UI.
Use it to: read dialogs and search messages globally · send/edit/forward/react/poll · download media and transcribe voice notes · moderate channels (ban/restrict/promote, invite links, slow-mode, admin log, forum topics) · manage stories, contacts, drafts, notifications, folders, privacy · or fall through to the raw MTProto bridge for anything else. All against a single signed-in user account—no bot required.
This server signs in as a real Telegram user (not a bot). Sessions live in~/.telegram-agent/. Treat that directory like a password.
Node.js >=20
Telegram API credentials from my.telegram.org/apps — api_id and api_hash
Related MCP server: telegram-mcp
This package is the MCP server — every tool schema (~12,700 tokens) sits in your agent's context on every turn. Good for any MCP client and for hosted runtimes that can't shell out.
If your agent is Claude Code / Codex CLI / Cursor / Gemini CLI / Cline / Windsurf, there's a companion package — telegram-agent — that ships the same Telegram surface as a universal agent skill. The agent only loads the skill instructions when your prompt mentions Telegram — ~50× lower context cost in idle. Standalone (no MCP server in the loop), but uses the same ~/.telegram-agent/ session store as this package — sign in once, use either or both.
npm i -g telegram-agent
telegram-agent login
npx skills add beautyfree/telegram-agent -a claude-code -gContinue below for the MCP install path.
Option A — automatic, all clients:
npx add-mcp mcp-telegram \
--env TELEGRAM_API_ID=123456 \
--env TELEGRAM_API_HASH=abc...add-mcp (from Neon) writes the correct config for Claude Desktop, Claude Code, Cursor, VS Code, Codex, Gemini CLI, Cline, Zed, Goose, OpenCode, and others. Pick the client in the interactive prompt.
Both env vars are required. Get them frommy.telegram.org/apps.
Option B — manual config:
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "mcp-telegram"],
"env": {
"TELEGRAM_API_ID": "123456",
"TELEGRAM_API_HASH": "abc..."
}
}
}
}{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "mcp-telegram"],
"env": {
"TELEGRAM_API_ID": "123456",
"TELEGRAM_API_HASH": "abc..."
}
}
}
}{
"servers": {
"telegram": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-telegram"],
"env": {
"TELEGRAM_API_ID": "123456",
"TELEGRAM_API_HASH": "abc..."
}
}
}
}claude mcp add telegram \
-e TELEGRAM_API_ID=123456 \
-e TELEGRAM_API_HASH=abc... \
-- npx -y mcp-telegram[mcp_servers.telegram]
command = "npx"
args = ["-y", "mcp-telegram"]
env = { TELEGRAM_API_ID = "123456", TELEGRAM_API_HASH = "abc..." }Ask your agent:
Sign in to my Telegram.
The agent calls the login tool. A browser tab opens. Enter your phone number, the SMS code, and 2FA password if you have one. The tab shows a green checkmark — you can close it. The session is now stored locally and the agent can read your Telegram.
To add another account, ask the agent to call login again.
102 tools covering the full Telegram user-account surface. Common ones below; the rest are grouped under collapsibles. Every tool accepts an optional accountId (omit when only one account is signed in). peer accepts a numeric chat id, an @username, or the literal "me" (Saved Messages).
Top of the menu:
Tool | What it does |
| Open the browser-based sign-in flow. Adds an account. |
| List signed-in accounts. |
| List dialogs/chats/channels. Filters: |
| List messages in a dialog. Newest first. |
| Search inside one dialog: |
| Search across every chat you have. |
| Find dialogs by name/title/username substring. |
| Send text. Supports |
| Send a file (local path or |
| Save the media on a message to disk. |
| Transcribe a voice/video note (Premium). |
| Call any raw MTProto method by name. Auto-resolves |
These are local-only: they manage which Telegram sessions live in ~/.telegram-agent/ and the settings UI. No Telegram API call beyond the sign-in flow itself.
Tool | What it does |
| List signed-in accounts. |
| Browser-based sign-in. Adds an account. |
| Drop a local session and revoke it on Telegram. |
| Open the local settings page (tool surface + read-only). |
Tool | What it does |
| Return the profile of the authenticated user. |
| Change own first/last name and bio. |
| Set or clear own |
| Set the account birthday. |
| Upload a new avatar (local path or URL). |
Tool | What it does |
| List dialogs. Filters: |
| Find dialogs by name/title/username substring. |
| Resolve |
| List custom dialog folders (chat filters). |
| List contacts. |
Tool | What it does |
| List messages in a dialog. |
| Search inside one dialog (text, type filter, sender, date range). |
| Search across every chat. |
| Fetch one or more messages by id. |
| Get reactions on messages. |
| Mark messages read up to an id. |
Tool | What it does |
| Send text. |
| Edit a previously sent message. |
| Delete by id (optionally revoke for all). |
| Forward messages between dialogs. |
| Pin / unpin in a dialog. |
| Set reactions on a message. |
| Send to a phone number, auto-creates a temporary contact. |
Tool | What it does |
| Send a file (path or URL). Albums via array. |
| Save a message's media to disk. |
| Save a peer's avatar to disk. |
| Transcribe voice/video (Premium). |
Tool | What it does |
| Send a poll. Supports quiz, multiple-choice, anonymous, close period. |
| Cast a vote. |
| Finalize a poll. |
| Fetch tally. |
Tool | What it does |
| Set emoji reactions on a message. |
| Read reactions. |
| Set account-wide default. |
Tool | What it does |
| Feed of contacts' stories. |
| One peer's stories. |
| Post a story (photo or video). |
| Delete own stories. |
| Mark stories viewed. |
| List who viewed your story. |
Tool | What it does |
| Full ban (optional |
| Lift restrictions. |
| Apply a custom rights mask. |
| Grant admin rights (with rank). |
| Strip admin rights. |
| Add users to a channel/supergroup. |
| Kick from chat/channel. |
| Single participant info. |
| Members with filter (admins/banned/bots/...) and substring search. |
| Remove every message by a user. |
| Recent admin events with event-type filter. |
Tool | What it does |
| Change title (works for channels, supergroups, and basic groups). |
| Change description. |
| Change avatar (path or URL). |
| Set/clear public |
| Check availability. |
| Set slow-mode seconds. |
| Author signatures on channel posts. |
| Hide history from new members. |
| Require admin approval to join. |
| Leave a channel/supergroup. |
| Extended info (about, counts, linked chat, slow-mode). |
| Extended user info (bio, common chats). |
Tool | What it does |
| New broadcast channel or supergroup (optional forum mode). |
| Permanently delete. |
| Basic group → supergroup. |
| Hand over creator rights (requires 2FA password). |
Tool | What it does |
| New link with optional expiry, usage cap, join-request gate. |
| List active or revoked links. |
| Revoke a specific link. |
| List users that joined via a link. |
Tool | What it does |
| List forum topics. |
| Create a new topic. |
| Rename, re-icon, close, hide. |
Tool | What it does |
| Save a draft for a dialog. |
| Drop the draft for a dialog. |
| List all dialog drafts. |
Tool | What it does |
| Mute a chat (optional |
| Unmute. |
| Read settings. |
| Update mute, previews, sound, story-mute. |
Tool | What it does |
| New folder with include/exclude rules. |
| Replace folder rules. |
| Remove a folder. |
| Set display order. |
Tool | What it does |
| All contacts. |
| Add a user to contacts. |
| Remove users from contacts. |
| Search contacts + global directory. |
Tool | What it does |
| Block / unblock. |
| Block list. |
| Read a privacy key. |
| Update a privacy key (mode + allow/disallow lists). |
Tool | What it does |
| Installed sticker sets. |
| Install by short name. |
| Pin a sticker to recent. |
Tool | What it does |
| List your boost slots. |
| Apply slots to a channel. |
Tool | What it does |
| Run an inline bot query. |
| Call any MTProto method by qualified name (e.g. |
Three env vars, applied in order:
Variable | Effect |
| Hide every destructive / mutating tool. |
| Strict allowlist — only these tools register. |
| Blocklist applied after the allowlist. |
Examples:
MCP_TELEGRAM_READONLY=1 # read-only agent
MCP_TELEGRAM_TOOLS='login,list*,search*,get*' # discovery-only
MCP_TELEGRAM_DISABLE='delete*,ban*,kick*,create_channel,delete_channel,transfer_ownership,invokeMtproto' # safer write setVariable | Required | Default | Notes |
| yes | — | From my.telegram.org/apps. If unset, the auth page prompts for it and saves to |
| yes | — | Same as above. |
| no |
| State + per-account session storage. Legacy |
| no |
| Where |
| no | — | Set to |
| no | — | Strict allowlist. Comma-separated tool names; supports |
| no | — | Blocklist applied after the allowlist. Same syntax. |
| no |
|
|
The three gating vars stack — MCP_TELEGRAM_READONLY → MCP_TELEGRAM_TOOLS → MCP_TELEGRAM_DISABLE.
# Read-only agent — every mutating tool is hidden
MCP_TELEGRAM_READONLY=1
# Discovery-only — only login + the list/search/get tools
MCP_TELEGRAM_TOOLS='login,list*,search*,get*,resolveUsername'
# Allow writes but keep destructive ones away from the agent
MCP_TELEGRAM_DISABLE='delete*,ban*,kick*,create_channel,delete_channel,transfer_ownership,invokeMtproto'
# Specific surface: read + send/edit only
MCP_TELEGRAM_TOOLS='login,list_accounts,list_dialogs,list_messages,search_messages,search_global,send_message,editMessage'In an MCP client config, drop these into the same env block as TELEGRAM_API_ID/TELEGRAM_API_HASH. To verify, re-open your client — the tools the server advertises are exactly the ones registered after the gates run.
~/.telegram-agent/
├── state.json known accounts (no secrets in here)
└── sessions/
└── <account_id>/ per-account MTProto sessionIf a Telegram session is invalidated server-side (logged out from another device, password rotated, etc.), the next tool call returns an error telling the agent to call login to re-authorize.
git clone https://github.com/beautyfree/mcp-telegram
cd mcp-telegram
npm install
echo "TELEGRAM_API_ID=...\nTELEGRAM_API_HASH=..." > .env
npm run devLayout:
src/
├── index.ts bin entry — stdio MCP server, tool registrations
├── telegram.ts MTProto client + login state machine
├── auth-browser.ts ephemeral HTTP server that drives the browser flow
├── auth-page.ts inline HTML for the auth page
├── state.ts persistent state in ~/.telegram-agent/
└── logger.tsMIT — see LICENSE.
Telegram MCP · MCP Telegram · Telegram MCP server · Telegram for Claude · Telegram for Cursor · Telegram for Claude Code · Telegram for VS Code · Telegram for Codex · Telegram for Cline · Telegram for Windsurf · Telegram for AI agents · Telegram MTProto MCP · Telegram user-account MCP · Telegram automation MCP · Model Context Protocol Telegram · MCP server Telegram · gramjs MCP
Add a user to your contacts.
Inputs: user (required), firstName (required), phone, lastName, +2 more.
Pin a sticker to the recently used list. Use unsave: true to remove it.
Inputs: accessHash (required), documentId (required), unsave, accountId.
Apply one or more boost slots to a channel.
Inputs: peer (required), slots (required), accountId.
Fully ban a user. Pass untilDate (unix seconds) to time-limit the ban; default is forever.
Inputs: peer (required), user (required), accountId, untilDate.
Block a user from contacting you.
Inputs: user (required), accountId.
Verify whether a desired channel/supergroup username is free.
Inputs: peer (required), username (required), accountId.
Equivalent to save_draft with an empty text.
Inputs: peer (required), accountId.
Finalize a poll so no further votes are accepted.
Inputs: peer (required), messageId (required), accountId.
Create a broadcast channel (broadcast: true) or a supergroup (megagroup: true).
Inputs: title (required), about, forum, accountId, +2 more.
Create a new dialog folder (chat filter). id is auto-assigned to the next free slot 2..255.
Inputs: title (required), excludeRead, includeBots, pinnedPeers, +8 more.
Generate a new invite link with optional expiry, usage cap, and join-request gate.
Inputs: peer (required), title, accountId, expireDate, +2 more.
Create a new topic in a forum-enabled supergroup.
Inputs: peer (required), title (required), accountId, iconColor, +1 more.
Permanently delete the channel. Creator only.
Inputs: peer (required), accountId.
Remove one or more users from the contact book.
Inputs: users (required), accountId.
Remove a folder by id.
Inputs: id (required), accountId.
Delete messages by id. revoke (default true) deletes for all participants where possible.
Inputs: peer (required), messageIds (required), revoke, accountId.
Wipe all messages in one Saved-Messages sub-dialog (forwards from a single origin peer). Irreversible.
Inputs: peer (required), maxId, maxDate, minDate, +1 more.
Remove stories you previously posted.
Inputs: storyIds (required), peer, accountId.
Wipe every message a given user has posted in the channel/supergroup.
Inputs: peer (required), user (required), accountId.
Remove all admin rights from a user.
Inputs: peer (required), user (required), accountId.
Download the media attached to a message. Files land in /root/.telegram-agent/downloads (override with MCP_TELEGRAM_DOWNLOADS env). Returns the absolute path.
Inputs: peer (required), messageId (required), accountId.
Download the profile photo of a user/chat/channel. Saved under /root/.telegram-agent/downloads.
Inputs: peer (required), accountId.
Set the description of a channel/supergroup. Max 255 chars.
Inputs: peer (required), about (required), accountId.
Replace the rules of an existing folder. id is required.
Inputs: id (required), title (required), excludeRead, includeBots, +9 more.
Edit the text of a previously sent message.
Inputs: peer (required), text (required), messageId (required), accountId, +2 more.
Upload a new avatar photo from a local path or URL.
Inputs: path (required), peer (required), accountId.
Set a new title. Works for channels, supergroups, and basic groups.
Inputs: peer (required), title (required), accountId.
Rename / re-icon / close / hide a topic.
Inputs: peer (required), topicId (required), title, closed, +3 more.
Forward messages from one dialog to another.
Inputs: toPeer (required), fromPeer (required), messageIds (required), silent, +2 more.
Return recent admin events. Set fields in events to true to include those categories; leave empty to include everything.
Inputs: peer (required), limit, query, events, +1 more.
Return extended info for a channel or supergroup (about, participants count, linked chat, slow mode).
Inputs: channel (required), accountId.
Server-suggested default emoji set for Saved-Messages tagging.
Inputs: accountId.
Run an inline bot query (the @bot query form) and return the results.
Inputs: bot (required), query (required), peer, offset, +1 more.
Return the profile of the authenticated user for the chosen account.
Inputs: accountId.
Fetch one or several messages from a dialog by their ids.
Inputs: ids (required), peer (required), accountId.
Fetch the current reactions for one or more messages in a dialog.
Inputs: peer (required), messageIds (required), accountId.
Return the current boost slots the user has available across channels.
Inputs: accountId.
Return the user's installed sticker sets.
Inputs: accountId.
Return notification settings for a peer.
Inputs: peer (required), accountId.
Return role, rights, and join date for one user in a channel/supergroup.
Inputs: peer (required), user (required), accountId.
Return active stories posted by one peer.
Inputs: peer (required), accountId.
Fetch the current vote tally for a poll message.
Inputs: peer (required), messageId (required), accountId.
Return current rules for one privacy key.
Inputs: key (required), accountId.
List the forum-style sub-dialogs inside Saved Messages — each grouping forwards from one origin peer.
Inputs: limit, accountId, excludePinned.
Fetch messages inside one Saved-Messages sub-dialog (filtered by original sender peer).
Inputs: peer (required), limit, offsetId, accountId.
Return all reaction-tags the user has set on Saved Messages, with their custom titles and per-tag message counts. Premium feature; works only on the me peer.
Inputs: peer, accountId.
Show who has viewed a story you posted.
Inputs: storyId (required), peer, limit, query, +1 more.
Return extended profile info (bio, common chats count, etc.) for a user.
Inputs: user (required), accountId.
Install a sticker set by its short name (e.g. "AnimatedEmojies").
Inputs: shortName (required), archived, accountId.
Add a user (or list of users) to a channel or supergroup.
Inputs: peer (required), users (required), accountId.
Call any Telegram API method by its qualified name (e.g. messages.SendMessage, channels.GetFullChannel, stories.GetAllStories). String values for fields named peer/channel/user/fromPeer/toPeer/bot/chat are auto-resolved to InputPeer/InputUser. Use this only when no dedicated tool fits — the API surface is huge and there are no per-method safety checks.
Inputs: method (required), params, accountId.
Remove a user from a chat/channel. Requires admin rights.
Inputs: peer (required), user (required), accountId.
Leave the channel. Use delete_channel to also remove it (creator only).
Inputs: peer (required), accountId.
Return the Telegram accounts currently signed in on this machine.
Inputs: no named parameters.
List users currently on the block list.
Inputs: limit, accountId.
List all users in the contact book.
Inputs: accountId.
List available Telegram dialogs, chats and channels for the chosen account.
Inputs: limit, folder, unread, archived, +2 more.
Return all dialog drafts the user has across chats.
Inputs: accountId.
Return the user-defined folders (a.k.a. chat filters) with their inclusion rules.
Inputs: accountId.
List users that joined a chat through a specific invite link.
Inputs: peer (required), link, limit, accountId, +1 more.
List all invite links the current user can see in a chat.
Inputs: peer (required), limit, adminId, revoked, +1 more.
List messages in a dialog. Newest first.
Inputs: peer (required), limit, accountId.
List members of a group, supergroup, or channel. Optional filter (admins/kicked/banned/bots) and substring search.
Inputs: peer (required), limit, filter, search, +1 more.
Return the stories feed (other users' active stories).
Inputs: hidden, accountId.
List topics in a supergroup with forum mode enabled.
Inputs: peer (required), limit, query, accountId.
Open a browser window where the user signs in to Telegram (phone → code → 2FA). Resolves once the user finishes. Use this when no account is signed in or to add another one.
Inputs: no named parameters.
Drop the local session for an account and revoke it on the Telegram side.
Inputs: accountId (required).
Mark a dialog (and optionally up to a specific message id) as read.
Inputs: peer (required), maxId, accountId.
One-way migration. Returns the new supergroup id in the resulting updates.
Inputs: chatId (required), accountId.
Mute a chat. Without untilDate, mutes forever.
Inputs: peer (required), accountId, untilDate.
Open a local browser tab where the user can toggle read-only mode and edit the tool allowlist / blocklist. Resolves when the user closes the tab. Changes are persisted to ~/.telegram-agent/state.json; the MCP client must be restarted to pick them up. Env vars (MCP_TELEGRAM_READONLY / TOOLS / DISABLE) override stored values and are shown as locked in the UI.
Inputs: no named parameters.
Pin a message in the dialog.
Inputs: peer (required), messageId (required), silent, accountId, +1 more.
Grant admin rights. Pass only the fields you want enabled; omitted fields default to false.
Inputs: peer (required), user (required), rights (required), rank, +1 more.
Set the display order of folders by passing the list of ids in the desired sequence.
Inputs: order (required), accountId.
Look up a user, channel, or chat by @username.
Inputs: username (required), accountId.
Set specific restrictions. true for a field means the user CANNOT do that action.
Inputs: peer (required), user (required), rights (required), accountId.
Permanently revoke a previously generated invite link.
Inputs: link (required), peer (required), accountId.
Save a draft for a dialog. Pass empty text to clear it.
Inputs: peer (required), text (required), replyTo, topMsgId, +2 more.
Search users/chats/channels by a query (matches name, username, and indexed text).
Inputs: query (required), limit, accountId.
Find dialogs by a substring against their name/title/username.
Inputs: query (required), limit, accountId.
Search messages across every chat the user is in. Useful for "find that link about X".
Inputs: query (required), limit, filter, maxDate, +2 more.
Search messages within one dialog. Supports text substring, type filter (photos/links/etc), sender filter, and date range. Newest first unless reverse=true.
Inputs: peer (required), limit, query, filter, +5 more.
Search inside Saved Messages (me). Combine free-text query with tagEmoji and/or tagCustomEmojiIds to filter by reaction-tag. Newest first.
Inputs: limit, query, maxDate, minDate, +4 more.
Upload and send one or more files. Each path may be an absolute local path or an https:// URL. Passing multiple paths sends them as an album.
Inputs: path (required), peer (required), silent, asPhoto, +5 more.
Send a text message to a dialog. Supports reply, forum topic, silent, scheduled delivery, and parse mode.
Inputs: peer (required), text (required), silent, replyTo, +5 more.
Send a Telegram message to someone identified only by their phone number. The phone is briefly added to contacts (Telegram requires this), the message is sent, then the contact entry is removed by default. Phone must include country code (e.g. +12025550123).
Inputs: text (required), phone (required), silent, lastName, +4 more.
Send a poll. For a quiz, set quiz: true and correctAnswerIndex (0-based). Use closePeriod (seconds) or closeDate (unix seconds) to auto-close.
Inputs: peer (required), answers (required), question (required), quiz, +8 more.
Set one or more reactions on a message. Pass an empty reaction list to remove existing reactions.
Inputs: peer (required), messageId (required), big, emoji, +3 more.
Publish a story (photo or video) on the chosen peer. Visibility defaults to "everyone".
Inputs: path (required), peer, period, pinned, +3 more.
Set the account birthday. Year is optional.
Inputs: day (required), month (required), year, accountId.
Set the quick reaction emoji shown on long-press in clients.
Inputs: emoji, accountId, customEmojiId.
Update notify settings for a peer (sound, show preview, mute, story mute).
Inputs: peer (required), silent, accountId, muteUntil, +2 more.
Replace the privacy rules for a key. mode chooses the base policy; allowUsers/disallowUsers add user-id exceptions.
Inputs: key (required), mode (required), accountId, allowUsers, +1 more.
Upload a new profile photo from a local path or URL.
Inputs: path (required), accountId.
Limit how often non-admins can post. Allowed values: 0 (off), 10, 30, 60, 300, 900, 3600 seconds.
Inputs: peer (required), seconds (required), accountId.
When enabled, new members must be approved by an admin.
Inputs: peer (required), enabled (required), accountId.
Pin/unpin one of the forum-style sub-dialogs inside Saved Messages.
Inputs: peer (required), pinned, accountId.
Broadcast channels only.
Inputs: peer (required), enabled (required), accountId.
Request a transcription of a voice note or video message. Requires a Telegram Premium account. The response may be pending — re-call to poll, passing the same message id.
Inputs: peer (required), messageId (required), accountId.
Transfer creator rights to another user. Requires the account 2FA password (Telegram enforces this).
Inputs: peer (required), newOwner (required), password (required), accountId.
Remove all restrictions for a user.
Inputs: peer (required), user (required), accountId.
Lift a previous block.
Inputs: user (required), accountId.
Clear a mute on a chat.
Inputs: peer (required), accountId.
Unpin a specific message, or pass no id to unpin everything in the dialog.
Inputs: peer (required), accountId, messageId.
Set or clear (empty string) own public username.
Inputs: username (required), accountId.
Change own first name, last name, or about. Omitted fields are left untouched.
Inputs: about, lastName, accountId, firstName.
Set or clear the custom title of a Saved-Messages reaction-tag. Pass title to rename, omit to clear. Premium feature.
Inputs: emoji, title, accountId, customEmojiId.
Assign a new public username. Pass an empty string to clear it.
Inputs: peer (required), username (required), accountId.
Increment view counters for the given stories.
Inputs: peer (required), storyIds (required), accountId.
Cast a vote on a poll by the index(es) of the chosen options.
Inputs: peer (required), messageId (required), answerIndexes (required), accountId.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 111 tools
Each tool targets a distinct resource and action, with specific names like send_story vs send_file. Some overlap exists between similar admin tools (ban_user vs restrict_user vs kick_participant), but descriptions clarify the differences. Overall, the boundaries are clear.
All tools use snake_case with a consistent verb_noun pattern (list, send, get, create, delete, edit, toggle). There are no mixed conventions or camelCase. Some verbs like 'get' vs 'list' are used interchangeably, but the pattern is uniform.
111 tools is far beyond the 15-tool sweet spot and in the extreme range. Even for a comprehensive Telegram client, this is an overwhelming surface that likely requires heavy filtering to be usable.
The tool set covers nearly every major Telegram feature: messaging, media, stories, admin, channels, folders, contacts, privacy, stickers, and more. The raw invoke_mtproto fallback fills any gaps, making the surface effectively complete.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
