This server offers a comprehensive, type-safe wrapper over the Telegram Bot API with useful engineering for AI use, but it is community-maintained and may lag behind the latest API versions.
telegram-api-mcp is a TypeScript-only MCP server that provides all 169 methods of the Telegram Bot API (Bot API v9.6; v10.2 per the manifest). It includes Zod parameter validation, token masking, tool annotations, response truncation, and resilience features like async-mutex token-bucket rate limiting (defaults: 30 requests/sec global and 20 messages/min per group, aligning with Telegram's official limits) and a 3-state circuit breaker (closed/open/half-open). It supports a meta-mode (TELEGRAM_META_MODE=true) that replaces the 169 individual tools with just two tools, telegram_find and telegram_call, to save ~99% of context tokens. It has only two runtime dependencies (@modelcontextprotocol/sdk and zod). The server communicates with clients via stdio. It is compatible with clients such as Claude Desktop, as per the README installation instructions, running through npx.
command: 'npx', args: ['telegram-api-mcp'], env: { TELEGRAM_BOT_TOKEN: 'your_token' }. 3. Alternatively, set the environment variable in your shell and run npx telegram-api-mcp locally with an MCP client that supports stdio.{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"telegram-api-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your_token_from_botfather"
}
}
}
}