Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "${TDLIB_API_ID}",
        "TDLIB_API_HASH": "${TDLIB_API_HASH}",
        "TDLIB_PHONE_NUMBER": "${TDLIB_PHONE_NUMBER}",
        "TDLIB_AUTH_CODE": "${TDLIB_AUTH_CODE}",
        "TDLIB_2FA_PASSWORD": "${TDLIB_2FA_PASSWORD}",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}

claude mcp add telegram-mcp-tdlib -e "TDLIB_API_ID=${TDLIB_API_ID}" -e "TDLIB_API_HASH=${TDLIB_API_HASH}" -e "TDLIB_PHONE_NUMBER=${TDLIB_PHONE_NUMBER}" -e "TDLIB_AUTH_CODE=${TDLIB_AUTH_CODE}" -e "TDLIB_2FA_PASSWORD=${TDLIB_2FA_PASSWORD}" -e "MCP_READ_ONLY=true" -e "MCP_TOOL_PROFILE=reader" -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH -e TDLIB_PHONE_NUMBER -e TDLIB_AUTH_CODE -e TDLIB_2FA_PASSWORD -e MCP_READ_ONLY -e MCP_TOOL_PROFILE ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio

[mcp_servers.telegram-mcp-tdlib]
command = "docker"
args = ["run", "-i", "--rm", "-e", "TDLIB_API_ID", "-e", "TDLIB_API_HASH", "-e", "TDLIB_PHONE_NUMBER", "-e", "TDLIB_AUTH_CODE", "-e", "TDLIB_2FA_PASSWORD", "-e", "MCP_READ_ONLY", "-e", "MCP_TOOL_PROFILE", "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"]
env = { "TDLIB_API_ID" = "${TDLIB_API_ID}", "TDLIB_API_HASH" = "${TDLIB_API_HASH}", "TDLIB_PHONE_NUMBER" = "${TDLIB_PHONE_NUMBER}", "TDLIB_AUTH_CODE" = "${TDLIB_AUTH_CODE}", "TDLIB_2FA_PASSWORD" = "${TDLIB_2FA_PASSWORD}", "MCP_READ_ONLY" = "true", "MCP_TOOL_PROFILE" = "reader" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "telegram-mcp-tdlib": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
      ],
      "enabled": true,
      "environment": {
        "TDLIB_API_ID": "{env:TDLIB_API_ID}",
        "TDLIB_API_HASH": "{env:TDLIB_API_HASH}",
        "TDLIB_PHONE_NUMBER": "{env:TDLIB_PHONE_NUMBER}",
        "TDLIB_AUTH_CODE": "{env:TDLIB_AUTH_CODE}",
        "TDLIB_2FA_PASSWORD": "{env:TDLIB_2FA_PASSWORD}",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}

{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "${TDLIB_API_ID}",
        "TDLIB_API_HASH": "${TDLIB_API_HASH}",
        "TDLIB_PHONE_NUMBER": "${TDLIB_PHONE_NUMBER}",
        "TDLIB_AUTH_CODE": "${TDLIB_AUTH_CODE}",
        "TDLIB_2FA_PASSWORD": "${TDLIB_2FA_PASSWORD}",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=telegram-mcp-tdlib&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIlRETElCX0FQSV9JRCIsIi1lIiwiVERMSUJfQVBJX0hBU0giLCItZSIsIlRETElCX1BIT05FX05VTUJFUiIsIi1lIiwiVERMSUJfQVVUSF9DT0RFIiwiLWUiLCJURExJQl8yRkFfUEFTU1dPUkQiLCItZSIsIk1DUF9SRUFEX09OTFkiLCItZSIsIk1DUF9UT09MX1BST0ZJTEUiLCJnaGNyLmlvL3RvbGJveS90ZWxlZ3JhbS1tY3AtdGRsaWI6MS4xNy4zLXN0ZGlvIl0sImVudiI6eyJURExJQl9BUElfSUQiOiIke1RETElCX0FQSV9JRH0iLCJURExJQl9BUElfSEFTSCI6IiR7VERMSUJfQVBJX0hBU0h9IiwiVERMSUJfUEhPTkVfTlVNQkVSIjoiJHtURExJQl9QSE9ORV9OVU1CRVJ9IiwiVERMSUJfQVVUSF9DT0RFIjoiJHtURExJQl9BVVRIX0NPREV9IiwiVERMSUJfMkZBX1BBU1NXT1JEIjoiJHtURExJQl8yRkFfUEFTU1dPUkR9IiwiTUNQX1JFQURfT05MWSI6InRydWUiLCJNQ1BfVE9PTF9QUk9GSUxFIjoicmVhZGVyIn19"
}

{
  "servers": {
    "telegram-mcp-tdlib": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "${TDLIB_API_ID}",
        "TDLIB_API_HASH": "${TDLIB_API_HASH}",
        "TDLIB_PHONE_NUMBER": "${TDLIB_PHONE_NUMBER}",
        "TDLIB_AUTH_CODE": "${TDLIB_AUTH_CODE}",
        "TDLIB_2FA_PASSWORD": "${TDLIB_2FA_PASSWORD}",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}

{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "${TDLIB_API_ID}",
        "TDLIB_API_HASH": "${TDLIB_API_HASH}",
        "TDLIB_PHONE_NUMBER": "${TDLIB_PHONE_NUMBER}",
        "TDLIB_AUTH_CODE": "${TDLIB_AUTH_CODE}",
        "TDLIB_2FA_PASSWORD": "${TDLIB_2FA_PASSWORD}",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}

extensions:
  "telegram-mcp-tdlib":
    enabled: true
    name: "telegram-mcp-tdlib"
    type: stdio
    cmd: "docker"
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "TDLIB_API_ID"
      - "-e"
      - "TDLIB_API_HASH"
      - "-e"
      - "TDLIB_PHONE_NUMBER"
      - "-e"
      - "TDLIB_AUTH_CODE"
      - "-e"
      - "TDLIB_2FA_PASSWORD"
      - "-e"
      - "MCP_READ_ONLY"
      - "-e"
      - "MCP_TOOL_PROFILE"
      - "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
    envs:
      "TDLIB_API_ID": "${TDLIB_API_ID}"
      "TDLIB_API_HASH": "${TDLIB_API_HASH}"
      "TDLIB_PHONE_NUMBER": "${TDLIB_PHONE_NUMBER}"
      "TDLIB_AUTH_CODE": "${TDLIB_AUTH_CODE}"
      "TDLIB_2FA_PASSWORD": "${TDLIB_2FA_PASSWORD}"
      "MCP_READ_ONLY": "true"
      "MCP_TOOL_PROFILE": "reader"
    timeout: 300

Placeholders to fill from your own secret store: ${TDLIB_API_HASH}, ${TDLIB_PHONE_NUMBER}, ${TDLIB_AUTH_CODE}, ${TDLIB_2FA_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

Tool list unknown · checked 2026-10-20 07:53 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance80

livenessn/a

freshness100

hygiene95

+repository +namespace-matches-repo ~liveness-unmeasured +updated-3d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

package	registry	version	runtime	secrets
`ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio`	oci	unpinned	–	`TDLIB_API_HASH`, `TDLIB_PHONE_NUMBER`, `TDLIB_AUTH_CODE`, `TDLIB_2FA_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.tolboy/telegram-mcp-tdlib",
  "title": "Telegram MCP Server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.17.3",
  "packages": [
    {
      "transport": {
        "type": "stdio"
      },
      "identifier": "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "TDLIB_API_ID",
          "format": "string",
          "isRequired": true,
          "description": "Telegram API ID from my.telegram.org"
        },
        {
          "name": "TDLIB_API_HASH",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "Telegram API hash from my.telegram.org"
        },
        {
          "name": "TDLIB_PHONE_NUMBER",
          "format": "string",
          "isSecret": true,
          "description": "Telegram phone number; omit after preparing a persisted session when using QR authentication"
        },
        {
          "name": "TDLIB_AUTH_CODE",
          "format": "string",
          "isSecret": true,
          "description": "One-time Telegram login code for a fresh headless container"
        },
        {
          "name": "TDLIB_2FA_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Telegram 2FA password when the account requires it"
        },
        {
          "name": "MCP_READ_ONLY",
          "format": "string",
          "default": "true",
          "description": "Keep true for safe first use"
        },
        {
          "name": "MCP_TOOL_PROFILE",
          "format": "string",
          "default": "reader",
          "description": "Tool surface: reader, inbox, community-admin, research, or all"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/tolboy/telegram-mcp-tdlib",
    "source": "github"
  },
  "description": "Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails."
}