psyb0t/docker-telethon-plusExposes a Telegram user account via MCP, enabling AI agents to send, read, and manage messages, chats, and media using full MTProto access through Telethon. It wraps Telethon behind a JSON HTTP API and MCP endpoint, allowing agents to interact with Telegram as the authenticated user.
TELETHON_API_IDstringREQUIREDTELETHON_DRY_RUNstringOPTIONALdefault: falseTELETHON_SESSIONstringREQUIREDTELETHON_API_HASHstringREQUIREDTELETHON_AUTH_KEYstringOPTIONALdefault: TELETHON_LOG_LEVELstringOPTIONALdefault: INFOTELETHON_READ_ONLYstringOPTIONALdefault: falseTELETHON_CACHE_PATHstringOPTIONALdefault: /cache/entities.jsonTELETHON_APP_VERSIONstringOPTIONALdefault: 1.0TELETHON_POST_TO_URLstringOPTIONALTELETHON_DEVICE_MODELstringOPTIONALdefault: docker-telethon-plusTELETHON_DOWNLOAD_DIRstringOPTIONALdefault: /tmp/telethon-plusTELETHON_CACHE_ENABLEDstringOPTIONALdefault: trueTELETHON_SYSTEM_VERSIONstringOPTIONALdefault: 1.0TELETHON_REQUEST_TIMEOUTstringOPTIONALdefault: 60TELETHON_THROTTLE_ENABLEDstringOPTIONALdefault: trueTELETHON_CACHE_TTL_SECONDSstringOPTIONALdefault: 604800TELETHON_THROTTLE_ADAPTIVEstringOPTIONALdefault: trueTELETHON_THROTTLE_JITTER_MSstringOPTIONALdefault: 200TELETHON_BUCKET_READ_PER_MINstringOPTIONALdefault: 600TELETHON_BUCKET_SEND_PER_MINstringOPTIONALdefault: 20TELETHON_HTTP_LISTEN_ADDRESSstringOPTIONALdefault: 0.0.0.0:8080TELETHON_UPDATES_BUFFER_SIZEstringOPTIONALTELETHON_BUCKET_JOIN_PER_HOURstringOPTIONALdefault: 5TELETHON_FLOOD_SLEEP_THRESHOLDstringOPTIONALdefault: 60TELETHON_BUCKET_CREATE_PER_HOURstringOPTIONALdefault: 5TELETHON_BUCKET_RESOLVE_PER_MINstringOPTIONALdefault: 5TELETHON_BUCKET_GET_FULL_PER_MINstringOPTIONALdefault: 10TELETHON_THROTTLE_GLOBAL_INTERVAL_MSstringOPTIONALdefault: 50TELETHON_THROTTLE_PER_CHAT_INTERVAL_MSstringOPTIONALdefault: 1100TELETHON_THROTTLE_PER_CHAT_READ_INTERVAL_MSstringOPTIONALdefault: 250Create a free RNWY account to connect your on-chain identity to this server. MCP server claiming is coming; register now and you'll be first in line.
Create your account →