Skip to content

overpod/mcp-telegram

v1.37.0 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

Published 1mo MCP SaaS Integrations
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-tools claude gramjs mcp mcp-server model-context-protocol
+4 more
mtproto telegram typescript userbot

Summary

AI summary

Added TELEGRAM_USE_WSS env-var for MTProto over port 443 and graceful handling when it conflicts with a proxy.

Changes in this release

Feature Low

Adds TELEGRAM_USE_WSS env-var to force port 443 for MTProto transport.

Adds TELEGRAM_USE_WSS env-var to force port 443 for MTProto transport.

Source: llm_adapter@2026-06-04

Confidence: high

 —
Bugfix Medium

Adds graceful handling when TELEGRAM_USE_WSS and proxy config conflict, logging a warning instead of crashing.

Adds graceful handling when TELEGRAM_USE_WSS and proxy config conflict, logging a warning instead of crashing.

Source: llm_adapter@2026-06-04

Confidence: high

 —
Full changelog

Added

  • TELEGRAM_USE_WSS env-var — set to true to make gramJS use port 443 instead of the default 80 for the MTProto TCPFull transport. Unblocks deployments on VPS/hosting IP ranges where outbound port 80 to Telegram DC IP blocks is dropped (anti-abuse policy on some shared-VPS providers like Hostinger/OVH), which otherwise hangs the client forever in Connecting to ...:80/TCPFull.... Default false — existing setups are unaffected.

    TELEGRAM_USE_WSS=true npx @overpod/mcp-telegram

  • Graceful proxy-conflict handling — gramJS cannot combine useWSS with a proxy (SSL transport over a proxy is unsupported). When both TELEGRAM_USE_WSS=true and TELEGRAM_PROXY_* are set, the conflict is now detected early: a clear warning is logged and useWSS is ignored (proxy takes precedence), instead of crashing deep inside connect().

Docs added to README + VitePress site (en/ru/zh).

Contributed by Ivan Ponomarev (@Baho73) via #47, merged in #48.

Full Changelog: https://github.com/mcp-telegram/mcp-telegram/compare/v1.36.5...v1.37.0

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track overpod/mcp-telegram

Get notified when new releases ship.

Sign up free

About overpod/mcp-telegram

Telegram MCP server via MTProto/GramJS — 20 tools for reading chats, searching messages, downloading media, managing contacts. QR code login, npx zero-install. Hosted version at mcp-telegram.com.

All releases →

Related context

Beta — feedback welcome: [email protected]