Telegram MCP Server
Provides tools for interacting with the Telegram Bot API, enabling AI agents to send messages, manage chats, handle inline queries, process payments, and perform all 162 Telegram Bot API methods.
Click on "Install 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., "@Telegram MCP ServerSend 'Hello from MCP' to chat -100123456789"
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.
Telegram MCP Server
Production-ready MCP server for the complete Telegram Bot API. 162 methods with token-optimized meta mode (~157 tokens vs ~55,000).
Highlights
Complete API coverage: All 162 Telegram Bot API methods
Token efficient: Meta mode reduces context by 99.7%
Production hardened: Circuit breaker, rate limiting, retries with backoff
Observable: Prometheus metrics, structured logging, health checks
Type safe: Full TypeScript with Zod validation
Related MCP server: agent-telegram-mcp
Installation
npm install @tonresistor/telegram-mcpOr clone and build from source:
git clone https://github.com/TONresistor/telegram-mcp.git
cd telegram-mcp && npm install && npm run buildQuick Start
Get your bot token from @BotFather, then add to your MCP config:
{
"mcpServers": {
"telegram": {
"command": "node",
"args": ["/path/to/build/index-meta.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_token_here"
}
}
}
}Usage Modes
Mode | Entry Point | Tools | Best For |
Meta (recommended) |
| 2 | Production: minimal token usage |
Standard |
| 161 | Development: direct tool access |
Meta mode exposes just 2 tools:
telegram_find: Search methods by name or categorytelegram_call: Execute any Telegram API method
Configuration
Variable | Default | Description |
| required | Bot token from BotFather |
|
| debug / info / warning / error / critical |
|
| Request timeout in ms (5000-120000) |
|
| Retry attempts (0-10) |
|
| Global rate limit (1-60) |
| — | Enable health endpoints (/health, /metrics) |
Features
Resilience
Circuit breaker: Opens after 5 failures, auto-recovers after 30s
Rate limiting: Global + per-chat (respects Telegram limits)
Retries: Exponential backoff with jitter
Observability
Prometheus metrics: Request counts, latencies, error rates
Health checks: Kubernetes-ready readiness/liveness probes
Structured logging: JSON format with automatic secret redaction
API Reference
All 161 Telegram Bot API methods organized by category.
Method | Description |
| Send text message |
| Send photo |
| Send video |
| Send audio file |
| Send document/file |
| Send GIF animation |
| Send voice message |
| Send video note (round video) |
| Send location |
| Send venue/place |
| Send phone contact |
| Send poll/survey |
| Send animated dice |
| Send typing indicator |
| Send media album |
| Send paid media |
| Stream partial message (AI) |
| Forward message |
| Forward multiple messages |
| Copy message |
| Copy multiple messages |
| Send sticker |
| Send checklist (business) |
Method | Description |
| Get chat info |
| Get member info |
| Get member count |
| List administrators |
| Ban user |
| Unban user |
| Restrict user |
| Promote to admin |
| Set admin title |
| Set default permissions |
| Set chat title |
| Set chat description |
| Set chat photo |
| Delete chat photo |
| Pin message |
| Unpin message |
| Unpin all messages |
| Leave chat |
| Generate invite link |
| Create invite link |
| Edit invite link |
| Revoke invite link |
| Approve join request |
| Decline join request |
| Ban channel |
| Unban channel |
| Set sticker set |
| Delete sticker set |
| Create subscription link |
| Edit subscription link |
Method | Description |
| Edit text |
| Edit caption |
| Edit media |
| Edit keyboard |
| Edit live location |
| Stop live location |
| Stop poll |
| Delete message |
| Delete multiple messages |
Method | Description |
| Set commands |
| Get commands |
| Delete commands |
| Set bot name |
| Get bot name |
| Set description |
| Get description |
| Set short description |
| Get short description |
| Set menu button |
| Get menu button |
| Set default admin rights |
| Get default admin rights |
| Get user photos |
| Get file info |
| Set emoji status |
Method | Description |
| Get connection info |
| Mark as read |
| Delete messages |
| Set account name |
| Set username |
| Set bio |
| Set profile photo |
| Remove photo |
| Set gift settings |
| Get star balance |
| Transfer stars |
| Post story |
| Edit story |
| Delete story |
| Repost story |
| Approve post |
| Decline post |
Method | Description |
| Get sticker set |
| Get custom emojis |
| Upload sticker |
| Create set |
| Add to set |
| Move position |
| Delete from set |
| Replace sticker |
| Set emojis |
| Set keywords |
| Set mask position |
| Set title |
| Set thumbnail |
| Set emoji thumbnail |
| Delete set |
Method | Description |
| Get icon stickers |
| Create topic |
| Edit topic |
| Close topic |
| Reopen topic |
| Delete topic |
| Unpin all |
| Edit General |
| Close General |
| Reopen General |
| Hide General |
| Unhide General |
| Unpin General |
Method | Description |
| Answer inline query |
| Answer callback |
| Answer Web App |
| Save prepared message |
| Set reaction |
| Get user boosts |
Method | Description |
| Send invoice |
| Create invoice link |
| Answer shipping |
| Answer pre-checkout |
| Get transactions |
| Refund payment |
| Edit subscription |
| Get balance |
Method | Description |
| Get available gifts |
| Send gift |
| Gift Premium |
| Get user gifts |
| Get chat gifts |
| Get business gifts |
| Convert to stars |
| Upgrade gift |
| Transfer gift |
Method | Description |
| Send game |
| Set score |
| Get high scores |
Method | Description |
| Get updates (polling) |
| Set webhook |
| Delete webhook |
| Get webhook info |
| Get bot info |
| Log out |
| Close instance |
Method | Description |
| Verify user |
| Verify chat |
| Remove user verification |
| Remove chat verification |
| Set Passport errors |
Development
npm test # Run tests
npm run build # Compile TypeScriptLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- 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/TONresistor/telegram-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server