{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tkfen6yegvpa","handle":"agent-telegram-mcp","url":"https://wellknown.network/agents/agent-telegram-mcp","links":{"self":"https://wellknown.network/agents/agent-telegram-mcp/record.json","html":"https://wellknown.network/agents/agent-telegram-mcp","markdown":"https://wellknown.network/agents/agent-telegram-mcp/record.md","api":"https://wellknown.network/api/v1/agents/agent-telegram-mcp","status":"https://wellknown.network/api/v1/agents/agent-telegram-mcp/status","claim":"https://wellknown.network/agents/agent-telegram-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/agent-telegram-mcp/claim.json","badge":"https://wellknown.network/agents/agent-telegram-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/agent-telegram-mcp/history","tools":"https://wellknown.network/api/v1/agents/agent-telegram-mcp/tools"},"ard":{"identifier":"urn:air::server:agent-telegram-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"agent-telegram-mcp","summary":"Telegram MCP Server — lets AI agents send/receive Telegram messages via a Bot Token","description":"# agent-telegram-mcp\n\nA 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.\n\n## Installation\n\nInstall using `pip` or `uv`:\n\n```bash\npip install agent-telegram-mcp\n```\nor \n```bash\nuv tool install agent-telegram-mcp\n```\n\n## Configuration\n\nThis 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.\n\nTo 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:\n\n### Example `mcp_config.json`\n```json\n{\n  \"mcpServers\": {\n    \"agent-telegram-mcp\": {\n      \"command\": \"agent-telegram-mcp\",\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"123456789:ABCdefGHIjklMNOpqrSTUvwxYZ\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nThe server exposes the following tools to the LLM agent:\n\n### ✉️ Messaging\n- **`telegram_send_message`**: Send text messages (supports Markdown, HTML, silent messages, and replies).\n- **`telegram_forward_message`**: Forward existing messages between chats.\n- **`telegram_delete_message`**: Delete a message from a chat (requires bot admin permissions).\n- **`telegram_pin_message`**: Pin a message in a group/channel.\n\n### 🖼️ Media & Files\n- **`telegram_send_photo`**: Send images via a local file path, public HTTP URL, or Telegram file ID.\n- **`telegram_send_video`**: Send video files.\n- **`telegram_send_audio`**: Send audio tracks (renders as a Telegram music player).\n- **`telegram_send_voice`**: Send voice notes (`.ogg` files).\n- **`telegram_send_document`**: Send arbitrary files (PDFs, ZIPs, code snippets, etc.).\n- **`telegram_send_sticker`**: Send `.webp` stickers.\n- **`telegram_send_location`**: Send a geographic m…","publisher":{"name":"Tharindu Mendis","url":null},"homepage":null,"repository":"https://github.com/tharindumendis/Agent_telegeam_mcp","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["agent","ai","bot","llm","mcp","stdio","telegram"],"pricing":null,"endpoints":[{"url":"pypi:agent-telegram-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"communication.sms-voice","name":"SMS & Voice","confidence":1,"provenance":"declared"},{"slug":"communication.chat","name":"Team Chat","confidence":0.768,"provenance":"derived"}],"categories":["communication"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"agent-telegram-mcp","registry":"pypi","observedAt":"2026-10-27T18:27:40.906Z","publishedAt":"2026-03-21T20:19:55.354992Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"agent-telegram-mcp","url":"https://pypi.org/project/agent-telegram-mcp/","firstSeenAt":"2026-09-09T08:21:21.819Z","fetchedAt":"2026-10-27T18:26:56.127Z","normalizedAt":"2026-10-27T18:26:56.127Z"}]},"firstSeenAt":"2026-09-09T08:21:21.819Z","updatedAt":"2026-10-27T18:27:40.906Z"}