MCP Server MCP

Telegram MCP Server

By github 👁 1 views ▲ 0 votes

Local-first TDLib Telegram MCP server with 110 tools, account isolation and production guardrails.

Homepage Verified source GitHub

Install

oci:ghcr.io/tolboy/telegram-mcp-tdlib:1.16.0-stdio

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/tolboy/telegram-mcp-tdlib:1.16.0-stdio",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Telegram API ID from my.telegram.org",
          "isRequired": true,
          "format": "string",
          "name": "TDLIB_API_ID"
        },
        {
          "description": "Telegram API hash from my.telegram.org",
          "isRequired": true,
          "format": "string",
          "isSecret": true,
          "name": "TDLIB_API_HASH"
        },
        {
          "description": "Telegram phone number; omit after preparing a persisted session when using QR authentication",
          "format": "string",
          "isSecret": true,
          "name": "TDLIB_PHONE_NUMBER"
        },
        {
          "description": "One-time Telegram login code for a fresh headless container",
          "format": "string",
          "isSecret": true,
          "name": "TDLIB_AUTH_CODE"
        },
        {
          "description": "Telegram 2FA password when the account requires it",
          "format": "string",
          "isSecret": true,
          "name": "TDLIB_2FA_PASSWORD"
        },
        {
          "description": "Keep true for safe first use",
          "format": "string",
          "default": "true",
          "name": "MCP_READ_ONLY"
        },
        {
          "description": "Tool surface: reader, inbox, community-admin, research, or all",
          "format": "string",
          "default": "reader",
          "name": "MCP_TOOL_PROFILE"
        }
      ]
    }
  ]
}

mcp model-context-protocol oci