timoncool

timoncool / telegram-api-mcp

Public

Ultimate Telegram Bot API MCP Server — full v9.6 coverage, meta-mode, rate limiting, circuit breaker

10
1
100% credibility
Found Apr 08, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This project creates a bridge allowing AI assistants to access and control every feature of the Telegram Bot API through a standardized protocol.

How It Works

1
🔍 Find the Helper

You discover a simple tool that lets your AI assistant take full control of a Telegram bot, like sending messages or managing groups.

2
🤖 Make Your Bot

You talk to BotFather in Telegram to create your own bot and note its unique identifier.

3
🔗 Connect to AI

You add your bot's identifier to your AI helper's easy settings file or quick command.

4
🚀 Start It Up

You launch the connection with a single go, and your AI gains superpowers to handle all Telegram actions safely.

5
Choose Mode
📋
Full Toolkit

AI sees every possible action ready to use anytime.

🔍
Smart Search

AI searches for the right action only when needed, keeping things light.

6
💬 Give Commands

You simply tell your AI what to do, like 'post a photo in my channel' or 'ban a spammer', and it does it perfectly.

🎉 Effortless Control

Now your AI runs your Telegram bot automatically, handling messages, polls, and more while you relax.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is telegram-api-mcp?

This TypeScript MCP server turns the full Telegram Bot API v9.6—169 methods for messages, media, polls, chats, business accounts, stories, gifts—into AI tools for Claude or similar agents. Run it via npx with a bot token, and your AI gets secure access to post polls, manage groups, or handle payments without exposing tokens or hitting rate limits. Meta-mode condenses it to two tools (find and call), slashing context tokens by 99% for long chats.

Why is it gaining traction?

Unlike scattered github ultimate sd upscale or ultimate vocal remover gui scripts, it delivers complete telegram bot api mcp coverage with built-in rate limiting (30 req/sec global, 20 msg/min per chat), retries, circuit breakers, and Zod param validation—production features that prevent AI meltdowns. Tool annotations flag read-only vs destructive calls, so agents auto-approve safe ones. Zero bloat (just two deps), token masking, and file upload guards make it trustable for real workflows.

Who should use this?

AI builders piping Civitai or Luxio ultimate telegram feeds into channels, Claude Desktop users automating ultimate telegram group posts, or devs crafting telegram ultimate team bots for polls and stories. Ideal for backend folks gluing LLMs to Telegram without custom wrappers, especially in ultimate pollbot telegram or media downloader pipelines.

Verdict

Grab it for Claude MCP setups—docs and quickstarts are solid, tests cover the basics, MIT license. With 10 stars and 1.0% credibility, it's early but mature enough for non-critical bots; watch for community growth.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.