{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9jkqu4cmm4x3","handle":"telegram-bot-mcp","url":"https://wellknown.network/agents/telegram-bot-mcp","links":{"self":"https://wellknown.network/agents/telegram-bot-mcp/record.json","html":"https://wellknown.network/agents/telegram-bot-mcp","markdown":"https://wellknown.network/agents/telegram-bot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/telegram-bot-mcp","status":"https://wellknown.network/api/v1/agents/telegram-bot-mcp/status","claim":"https://wellknown.network/agents/telegram-bot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/telegram-bot-mcp/claim.json","badge":"https://wellknown.network/agents/telegram-bot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/telegram-bot-mcp/history","tools":"https://wellknown.network/api/v1/agents/telegram-bot-mcp/tools"},"ard":{"identifier":"urn:air::server:telegram-bot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"telegram-bot-mcp","summary":"Telegram Bot MCP Server - publish, edit, and search messages in Telegram channels","description":"# Telegram Bot MCP Server\n\nA Model Context Protocol (MCP) server that enables AI assistants to publish, edit, search, and manage messages in Telegram channels.\n\n## Features\n\n- **Publish Text Messages**: Post new text messages to Telegram channels with formatting support (Markdown/HTML)\n- **Publish Photos**: Post photos with optional captions to Telegram channels\n- **Edit Text Messages**: Modify existing text-only messages in channels\n- **Edit Photo Captions**: Update captions of existing photo messages\n- **Delete Messages**: Remove messages from channels\n- **Search Messages**: Search through cached messages (local cache)\n- **Channel Info**: Retrieve channel metadata and statistics\n\n## Quick Reference\n\n| Task | Message Type | Tool to Use |\n|------|-------------|-------------|\n| Publish a text message | Text | `publish_message` |\n| Publish a photo | Photo | `publish_photo` |\n| Edit a text-only message | Text | `edit_message` |\n| Edit a photo's caption | Photo | `edit_message_caption` |\n| Delete any message | Any | `delete_message` |\n| Search cached messages | Any | `search_messages` |\n| Get channel info | - | `get_channel_info` |\n\n**Important:** You cannot use `edit_message` on photo messages or `edit_message_caption` on text messages!\n\n## Installation\n\n### Prerequisites\n\n1. **Python 3.10+** is required\n2. **Create a Telegram Bot**:\n   - Open Telegram and search for [@BotFather](https://t.me/botfather)\n   - Send `/newbot` and follow the instructions\n   - Copy the bot token (format: `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`)\n\n3. **Add Bot to Your Channel**:\n   - Create a Telegram channel or use an existing one\n   - Add your bot as an administrator to the channel\n   - Grant the bot permissions:\n     - Post messages\n     - Edit messages of others\n     - Delete messages of others\n\n4. **Get Channel ID**:\n   - For public channels, use the username format: `@channelname`\n   - For private channels, you need the numeric chat ID (e.g., `-1001234567890`)\n   - You can get this…","publisher":null,"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["bot","mcp","model-context-protocol","server","telegram"],"pricing":null,"endpoints":[{"url":"pypi:telegram-bot-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"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":"telegram-bot-mcp","registry":"pypi","observedAt":"2026-10-29T00:26:51.971Z","publishedAt":"2026-04-01T17:41:40.591124Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"telegram-bot-mcp","url":"https://pypi.org/project/telegram-bot-mcp/","firstSeenAt":"2026-09-10T13:21:12.665Z","fetchedAt":"2026-10-29T00:24:46.396Z","normalizedAt":"2026-10-29T00:24:46.396Z"}]},"firstSeenAt":"2026-09-10T13:21:12.665Z","updatedAt":"2026-10-29T00:26:51.971Z"}