Telegram MCP Server — lets AI agents send/receive Telegram messages via a Bot Token
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"agent-telegram-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# agent-telegram-mcp A robust Model Context Protocol (MCP) server that enables AI agents to seamlessly interact with Telegram using a standard Bot Token. It provides a comprehensive suite of tools for bidirectional communication, including sending and receiving text messages, multimedia, documents, and managing chats. ## Installation Install using `pip` or `uv`: ```bash pip install agent-telegram-mcp ``` or ```bash uv tool install agent-telegram-mcp ``` ## Configuration This MCP server requires a Telegram Bot Token. You can create a new bot and obtain your token by talking to the [BotFather](https://t.me/botfather) on Telegram. To use this server with MCP-compatible clients (like Claude Desktop, Agent_head, etc.), add it to your server configuration and pass the token as an environment variable: ### Example `mcp_config.json` ```json { "mcpServers": { "agent-telegram-mcp": { "command": "agent-telegram-mcp", "env": { "TELEGRAM_BOT_TOKEN": "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ" } } } } ``` ## Available Tools The server exposes the following tools to the LLM agent: ### ✉️ Messaging - **`telegram_send_message`**: Send text messages (supports Markdown, HTML, silent messages, and replies). - **`telegram_forward_message`**: Forward existing messages between chats. - **`telegram_delete_message`**: Delete a message from a chat (requires bot admin permissions). - **`telegram_pin_message`**: Pin a message in a group/channel. ### 🖼️ Media & Files - **`telegram_send_photo`**: Send images via a local file path, public HTTP URL, or Telegram file ID. - **`telegram_send_video`**: Send video files. - **`telegram_send_audio`**: Send audio tracks (renders as a Telegram music player). - **`telegram_send_voice`**: Send voice notes (`.ogg` files). - **`telegram_send_document`**: Send arbitrary files (PDFs, ZIPs, code snippets, etc.). - **`telegram_send_sticker`**: Send `.webp` stickers. - **`telegram_send_location`**: Send a geographic m…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.