About Telegram Bot API
Telegram Bot API is an MCP server published by 0xdeadbeef-all in the RAG category: provides full coverage of the Telegram Bot API with 166 methods across all API categories.
The repository has 3 stars and 0 forks, with the last commit 6 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/0xdeadbeef-all/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 Telegram Bot API
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
telegram-bot-mcp
MCP server and CLI for the Telegram Bot API. Full coverage of 166 methods across all API categories.
Built with Rust, rmcp 1.3, tokio, reqwest.
Features
- 166 Bot API methods — messages, media, chats, forums, stickers, inline, payments, games, passport, gifts
- MCP server (stdio transport) — works with Claude Code, Claude Desktop, and any MCP client
- CLI mode — direct method calls for agents and scripts without MCP support
- Single binary — no runtime dependencies, fast startup
API Coverage
| Module | Methods | Examples |
|---|---|---|
| Bot info | 16 | getMe, setMyCommands, setMyName, setMyProfilePhoto |
| Updates | 4 | getUpdates, setWebhook, deleteWebhook, getWebhookInfo |
| Messages | 10 | sendMessage, forwardMessage, copyMessage, pinChatMessage |
| Editing | 9 | editMessageText, editMessageCaption, deleteMessage |
| Media | 14 | sendPhoto, sendVideo, sendDocument, sendPoll, sendDice |
| Chats | 27 | getChat, banChatMember, promoteChatMember, setChatPermissions |
| Forums | 13 | createForumTopic, editForumTopic, closeForumTopic |
| Stickers | 16 | sendSticker, createNewStickerSet, setStickerSetTitle |
| Inline | 4 | answerCallbackQuery, answerInlineQuery |
| Payments | 7 | sendInvoice, createInvoiceLink, getStarTransactions |
| Games | 3 | sendGame, setGameScore, getGameHighScores |
| Business | 11 | readBusinessMessage, setBusinessAccountName, transferBusinessAccountStars |
| Stories | 4 | postStory, editStory, deleteStory, repostStory |
| Other | 28 | sendGift, verifyUser, sendChecklist, getUserGifts, getFile |
Installation
From crates.io
cargo install telegram-bot-mcp
From source
git clone https://github.com/0xDEADBEEF-all/telegram-bot-mcp.git
cd telegram-bot-mcp
cargo build --release
Setup
- Get a bot token from @BotFather
- Add to your MCP config (
~/.mcp.jsonor project.mcp.json):
{
"mcpServers": {
"telegram-bot": {
"command": "telegram-bot-mcp",
"env": {
"TELEGRAM_BOT_TOKEN": "your-token-from-botfather"
}
}
}
}
- Restart your MCP client (Claude Code, Claude Desktop, etc.)
Usage
MCP Server (default)
# Starts stdio MCP server (used automatically by MCP clients)
TELEGRAM_BOT_TOKEN=123:abc telegram-bot-mcp
# or via flag
telegram-bot-mcp --token 123:abc
CLI Mode
# List all available methods
./telegram-bot-mcp list
# Call a method (no params)
./telegram-bot-mcp -t 123:abc call getMe
# Call with JSON params
./telegram-bot-mcp -t 123:abc call sendMessage '{"chat_id":"123","text":"hello"}'
# Call with token from env
TELEGRAM_BOT_TOKEN=123:abc ./telegram-bot-mcp call sendDice '{"chat_id":"123","emoji":"🎰"}'
CLI output is JSON on stdout, errors on stderr, exit code 0/1.
Project Structure
src/
├── main.rs # Entry point, CLI parsing, MCP transport
├── bot_api.rs # Telegram Bot API HTTP client
├── cli.rs # CLI mode handler
├── server.rs # MCP ServerHandler + ToolRouter
└── tools/
├── mod.rs # Router composition
├── bot.rs # Bot info & commands (16 methods)
├── updates.rs # Updates & webhooks (4 methods)
├── messages.rs # Sending & pinning (10 methods)
├── editing.rs # Editing & deleting (9 methods)
├── media.rs # Photos, videos, polls, etc. (14 methods)
├── chats.rs # Chat management (27 methods)
├── forum.rs # Forum topics (13 methods)
├── stickers.rs # Sticker operations (16 methods)
├── inline.rs # Inline & callbacks (4 methods)
├── payments.rs # Invoices & Stars (7 methods)
├── games.rs # Games (3 methods)
├── business.rs # Business accounts (11 methods)
├── stories.rs # Stories (4 methods)
└── other.rs # Gifts, verification, passport, etc. (28 methods)
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.