{
  "name": "io.github.chigwell/telegram-mcp",
  "description": "A community-maintained MCP that wraps the Telegram Bot API so an AI agent can send messages, read updates from chats the bot is in, and respond to commands. Designed for notification flows (send updates to a channel) and lightweight assistant flows (respond to user messages from a chat).",
  "status": "active",
  "version": "latest",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-05-27",
    "com.top-mcps/score": {
      "value": 79,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-02T13:16:41.652Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-02T11:55:52.388Z",
      "githubStars": 1136,
      "lastCommitAt": "2026-05-27T06:52:10Z",
      "npmWeeklyDownloads": 44
    }
  },
  "repository": {
    "url": "https://github.com/chigwell/telegram-mcp",
    "source": "github"
  },
  "author": {
    "name": "Community"
  },
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "telegram-mcp",
      "version": "latest",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "TELEGRAM_BOT_TOKEN",
          "description": "TELEGRAM_BOT_TOKEN — required credential for Telegram.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "security": {
      "scope": "network",
      "sandbox": "Telegram bot token in env. Token grants the full bot identity; rotate via @BotFather if it leaks. The bot can only post in chats it has been added to.",
      "gotchas": [
        "Bot tokens, if leaked, give full bot identity — anyone can post as the bot. Treat like any API key.",
        "Telegram rate-limits messages per chat (30/sec) and per bot (no fixed number but enforced).",
        "Channel posts cannot be deleted past the configured retention window."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/telegram",
    "markdown": "https://top-mcps.com/mcp/telegram.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}