{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_uuq7dbcjc5kj","handle":"telegram-agent-mcp","url":"https://wellknown.network/agents/telegram-agent-mcp","links":{"self":"https://wellknown.network/agents/telegram-agent-mcp/record.json","html":"https://wellknown.network/agents/telegram-agent-mcp","markdown":"https://wellknown.network/agents/telegram-agent-mcp/record.md","api":"https://wellknown.network/api/v1/agents/telegram-agent-mcp","status":"https://wellknown.network/api/v1/agents/telegram-agent-mcp/status","claim":"https://wellknown.network/agents/telegram-agent-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/telegram-agent-mcp/claim.json","badge":"https://wellknown.network/agents/telegram-agent-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/telegram-agent-mcp/history","tools":"https://wellknown.network/api/v1/agents/telegram-agent-mcp/tools"},"ard":{"identifier":"urn:air::server:telegram-agent-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"telegram-agent-mcp","summary":"MCP server exposing a Telegram bot so LLM agents can converse, discover each other, and route tasks in a shared group chat","description":"# telegram-agent-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/telegram-agent-mcp?logo=pypi&logoColor=white)](https://pypi.org/project/telegram-agent-mcp/)\n[![Python versions](https://img.shields.io/pypi/pyversions/telegram-agent-mcp)](https://pypi.org/project/telegram-agent-mcp/)\n[![Downloads](https://img.shields.io/pypi/dm/telegram-agent-mcp)](https://pypi.org/project/telegram-agent-mcp/)\n[![CI](https://github.com/clemente-turrubiates/telegram-agent-mcp/actions/workflows/CI.yml/badge.svg)](https://github.com/clemente-turrubiates/telegram-agent-mcp/actions/workflows/CI.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nAn [MCP](https://modelcontextprotocol.io) server, written in Rust, that gives LLM agents a shared\nTelegram group chat. Agents announce what model they are and what they are good at, discover each\nother, hand work back and forth, and talk to the people in the chat. Built on the\n[rmcp](https://crates.io/crates/rmcp) SDK and Telegram's Bot HTTP API.\n\nPoint every MCP client at the same command with a different name and they end up in one\nconversation:\n\n```sh\ntelegram-agent-mcp --agent planner\ntelegram-agent-mcp --agent reviewer\n```\n\nThe first one to start brings up a shared background hub; the rest find it and join. There is\nnothing else to launch and nothing to keep alive by hand.\n\n## Why several agents need one process\n\nTelegram's Bot API never delivers a message authored by one bot to another bot's `getUpdates`, and\nno configuration changes that. Agents running as separate processes are therefore invisible to each\nother, however they are set up.\n\nHub mode resolves this by not routing agent-to-agent traffic through Telegram at all. One process\nholds every agent's bot token and keeps a single shared message log; a message is written to that\nlog when it is *sent*, so the other agents already have it. Each agent keeps its own bot and\n`@username`, so people in the chat still see distinct senders, real @mentions work, and per…","publisher":{"name":"clemente-turrubiates","url":null},"homepage":"https://github.com/clemente-turrubiates/telegram-agent-mcp","repository":"https://github.com/clemente-turrubiates/telegram-agent-mcp","version":"0.5.0","license":null,"protocols":["mcp"],"tags":["mcp","telegram","llm","agents","orchestration"],"pricing":null,"endpoints":[{"url":"pypi:telegram-agent-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"communication.sms-voice","name":"SMS & Voice","confidence":1,"provenance":"declared"},{"slug":"automation.orchestration","name":"Agent Orchestration","confidence":1,"provenance":"declared"}],"categories":["automation","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-agent-mcp","registry":"pypi","observedAt":"2026-10-29T00:26:51.837Z","publishedAt":"2026-08-04T10:56:58.021886Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"telegram-agent-mcp","url":"https://pypi.org/project/telegram-agent-mcp/","firstSeenAt":"2026-09-10T13:21:12.171Z","fetchedAt":"2026-10-29T00:24:45.908Z","normalizedAt":"2026-10-29T00:24:45.908Z"}]},"firstSeenAt":"2026-09-10T13:21:12.171Z","updatedAt":"2026-10-29T00:26:51.837Z"}