{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7u94tjbjnkqn","handle":"yeabsira-driba-mcp-telegram","url":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram","links":{"self":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram/record.json","html":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram","markdown":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram/record.md","api":"https://wellknown.network/api/v1/agents/yeabsira-driba-mcp-telegram","status":"https://wellknown.network/api/v1/agents/yeabsira-driba-mcp-telegram/status","claim":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram/claim.json","badge":"https://wellknown.network/agents/yeabsira-driba-mcp-telegram/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/yeabsira-driba-mcp-telegram/history","tools":"https://wellknown.network/api/v1/agents/yeabsira-driba-mcp-telegram/tools"},"ard":{"identifier":"urn:air::server:yeabsira-driba-mcp-telegram","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-telegram","summary":"MCP Server for Telegram","description":"<div align=\"center\">\n  <img src=\"logo.png\" alt=\"MCP Telegram Logo\" width=\"150\"/>\n  <h2 style=\"margin-top: 0\">Enable LLMs to control your Telegram</h2>\n</div>\n\n[![GitHub stars](https://img.shields.io/github/stars/dryeab/mcp-telegram?style=social)](https://github.com/dryeab/mcp-telegram/stargazers) [![PyPI version](https://badge.fury.io/py/mcp-telegram.svg)](https://badge.fury.io/py/mcp-telegram) [![Twitter Follow](https://img.shields.io/twitter/follow/dryeab?style=social)](https://twitter.com/dryeab)\n\n**Connect Large Language Models to Telegram via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction).**\n\nBuilt with [Telethon](https://github.com/LonamiWebs/Telethon), this server allows AI agents to interact with Telegram, enabling features like sending/editing/deleting messages, searching chats, managing drafts, downloading media, and more using the [MTProto](https://core.telegram.org/mtproto).\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Python 3.10 or higher\n- [`uv`](https://github.com/astral-sh/uv) Install via the [official uv guide](https://github.com/astral-sh/uv#installation).\n\n### Installation\n\nInstall the `mcp-telegram` CLI tool:\n\n```bash\nuv tool install mcp-telegram\n```\n\n## ⚙️ Usage\n\n> [!IMPORTANT]\n> Please ensure you have read and understood Telegram's [ToS](https://telegram.org/tos) before using this tool. Misuse of this tool may result in account restrictions.\n\nThe `mcp-telegram` command-line tool is your entry point.\n\n```bash\nmcp-telegram --help # See all commands\n```\n\n### Login\n\nFirst, authenticate with your Telegram account:\n\n```bash\nmcp-telegram login\n```\n\nThis interactive command will prompt you for:\n\n- **API ID & API Hash:** Obtain these from [my.telegram.org/apps](https://my.telegram.org/apps).\n- **Phone Number:** Your Telegram-registered phone number (international format, e.g., `+1234567890`).\n- **Verification Code:** Sent to your Telegram account upon first login.\n- **2FA Password:** If you have Two-Factor Authenticat…","publisher":{"name":"Yeabsira Driba","url":null},"homepage":null,"repository":"https://github.com/dryeab/mcp-telegram/issues","version":"0.1.11","license":"MIT","protocols":["mcp"],"tags":["automation","git","llm","mcp","telegram"],"pricing":null,"endpoints":[{"url":"pypi:mcp-telegram","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":"dev.version-control","name":"Version Control","confidence":1,"provenance":"declared"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"}],"categories":["communication","dev"],"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":"mcp-telegram","registry":"pypi","observedAt":"2026-10-28T14:24:43.043Z","publishedAt":"2025-04-15T15:15:36.270830Z","latestVersion":"0.1.11"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-telegram","url":"https://pypi.org/project/mcp-telegram/","firstSeenAt":"2026-09-10T04:23:39.883Z","fetchedAt":"2026-10-28T14:23:35.591Z","normalizedAt":"2026-10-28T14:23:35.591Z"}]},"firstSeenAt":"2026-09-10T04:23:39.883Z","updatedAt":"2026-10-28T14:24:43.043Z"}