telegram-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_API_ID | Yes | Your Telegram API ID from my.telegram.org | |
| TELEGRAM_API_HASH | Yes | Your Telegram API hash from my.telegram.org |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whoamiA | Show which Telegram account this server is signed in as. |
| list_chatsA | List recent dialogs, newest first. Use the returned chat_id for every other tool. |
| search_chatsA | Find dialogs by title or username. Matches across scripts, so "Вадим" finds "Vadim" and "Sasha" finds "Саша". Several chats often match a common first name — check the results and pick the right chat_id before sending anything. |
| search_public_chatsA | Search all of Telegram — not the user's own dialogs — for public channels, groups, bots and users by name or @username. Use this to find a chat the user has never opened; use search_chats for the ones they already have. Results are split into "mine" (their own contacts and dialogs) and "public" (everyone else). Public results are strangers: several channels share one name, and the flags say which is verified and which is flagged as a scam. |
| search_public_postsA | Full-text search over posts in every public channel on Telegram, whether or not the user follows them. This is the whole network, not the account: use search_messages for the user's own chats. Telegram rations these searches — the result reports how many free ones are left today, so do not spend them on repeated near-identical queries. |
| get_historyA | Read the most recent messages of a chat, newest first. Read-only: this does not mark anything as read. |
| search_messagesA | Full-text search over messages, inside one chat or across the whole account when chat is omitted. |
| send_messageA | Send a text message. It is delivered immediately and there is no undo — confirm the chat_id came from list_chats or search_chats first. |
| send_fileA | Upload a local file to a chat. Delivered immediately, no undo. |
| download_mediaB | Download the media attached to one message. Returns the saved path. |
| list_contactsA | List saved contacts. |
| mark_readA | Mark a chat as read. The other side sees read receipts — this is visible to them. |
| sample_my_messagesA | Collect messages the user themselves wrote, as raw material for describing how they write. Private chats only, text only, no recipients — this is a style sample, not a transcript. |
| save_style_profileA | Store the description of how the user writes. Replaces any previous one. It is loaded on every start and used when drafting on their behalf. |
| get_style_profileA | Show the stored writing-style profile, if there is one. |
| forget_style_profileA | Delete the stored writing-style profile. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| personalize | Read messages I have sent, describe how I write, and save it locally at /root/.telegram-mcp/style.md for drafting later. |
| draft_reply | Write a reply using the saved style profile. Shows it, never sends. |
| catch_up | Go through unread dialogs and report what needs an answer. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vkruglikov/telegram-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server