π¦
FantomaSkaRus1/telegram-bot-mcp
featured Telegram Bot API MCP server with 174 tools covering the entire Bot API.
0 installs
Trust: 34 β Low
Comms
Ask AI about FantomaSkaRus1/telegram-bot-mcp
Powered by Claude Β· Grounded in docs
I know everything about FantomaSkaRus1/telegram-bot-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
telegram-bot-mcp
Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API β messages, chats, stickers, payments, forums, stories, and more.
Features
- Messages β send (text, photo, video, audio, document, location, poll, dice, sticker, media groups), edit, forward, copy, delete, pin/unpin, reactions
- Chats β info, settings, permissions, invite links, member management, verification
- Bot β commands, profile, settings, description, menu button, admin rights
- Stickers β create/edit/delete sticker sets, upload stickers, custom emoji
- Payments β invoices, star transactions, gifts, refunds
- Forums β create/edit/close/reopen/delete topics
- Stories β post, edit, delete, repost
- Business β business messages, accounts, connections
- Games β send games, set scores, high scores
- Webhooks β set, delete, get info
Quick Start
npm install
Claude Code
claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"telegram": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-telegram/index.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_token"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN | Yes | Bot token from @BotFather |
TELEGRAM_DEFAULT_CHAT_ID | No | Default chat ID (skip chat_id in tool calls) |
TELEGRAM_DEFAULT_THREAD_ID | No | Default topic/thread ID for forum supergroups |
Project Structure
index.js # Entry point β registers all tool modules
utils/api.js # Telegram API client, rate limiting, retry logic
tools/
messages/ # send, edit, forward, manage
chat/ # info, settings, invite, members, verify
bot/ # core, commands, profile, settings
stickers.js
payments.js
forum.js
stories.js
business.js
games.js
webhook.js
License
MIT
