About FantomaSkaRus1/telegram-bot-mcp
FantomaSkaRus1/telegram-bot-mcp is an MCP server published by FantomaSkaRus1 in the Developer Tools category: full-featured Telegram Bot API MCP server with 174 tools for Claude Code and AI agents.
The repository has 7 stars and 1 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/FantomaSkaRus1/telegram-bot-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about FantomaSkaRus1/telegram-bot-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
README fetched from the repository 5 days ago. The original is authoritative.