Telegram MCP 0.4.0

• Telethon 1.44.0 → 1.45.0 (MTProto layer 227 → 229), backward-compatible: types.User, types.Channel, types.ChatAdminRights and types.ChatBannedRights only gained optional trailing keyword arguments.
• MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) on every tool, matching the telegram:read/telegram:write split. Hints only; scopes, bindings and the write allowlist still enforce access.
• telegram_check_update: read-only, suggest-only check of the latest GitHub release with release notes link and update command (3 s timeout, 24 h cache, offline result). A cached newer release adds a one-line startup hint; a stale cache is refreshed on a background thread. Opt out with TELEGRAM_MCP_DISABLE_UPDATE_CHECK=1.
• The update check goes through the same registrar as the Telegram tools (stdio local scopes, account binding, audit, per-account quota). Only plain version tags (v1.2.3) and this repository's release URLs are reported; failed requests back off for 30 minutes and force=true is honoured at most once a minute.
• The clean-install gate disables the update check and blocks external DNS in its server process.

English setup · Описание по-русски

Download the wheel or source archive below and verify SHA256SUMS. The installed setup
command generates local JSON/TOML client configuration; a source checkout is optional.
Your own provider credentials and API permissions remain required.

Verified on Python 3.12, 3.13 and 3.14 on Linux and Windows: existing contracts,
synthetic functional tests, clean wheel installation and real MCP stdio checks.
Live provider accounts and production deployment were outside this release verification.
GitHub verification · Source commit 095cd179757e4ac18ea3fec244d2313488ea5e25.

ZAI.ONE is a digital agency for websites, SEO, advertising and analytics.
ZAI.ONE — интернет-агентство: сайты, SEO, реклама и аналитика.
Contact / Написать в Telegram about setup and integration.

LicenseRef-ZAI-ONE permits installation and internal use on your own or authorized
accounts; it is not an open-source license. Third-party rights remain unchanged.
Stars are welcome. Request changes through Issues.