.env.example

# Required: Bot token from @BotFather
TELEGRAM_BOT_TOKEN=your-token-here

# Optional: Default chat ID (skip chat_id in every tool call)
# TELEGRAM_DEFAULT_CHAT_ID=-1001234567890

# Optional: Default thread ID for forum topics
# TELEGRAM_DEFAULT_THREAD_ID=123

# Optional: Meta-mode (2 tools instead of 150+, saves ~99% context tokens)
# TELEGRAM_META_MODE=true

# Optional: Rate limiting (defaults match Telegram FAQ limits)
# See: https://core.telegram.org/bots/faq#my-bot-is-hitting-limits
# TELEGRAM_GLOBAL_RATE_LIMIT=30       # Max requests/second (Telegram: ~30/sec for broadcasts)
# TELEGRAM_PER_CHAT_RATE_LIMIT=20     # Max messages/minute per group (Telegram: 20/min per group)

# Optional: Retry & Circuit breaker
# TELEGRAM_MAX_RETRIES=3              # Max retry attempts (default: 3)
# TELEGRAM_CB_THRESHOLD=5             # Failures to open circuit (default: 5)
# TELEGRAM_CB_COOLDOWN=30000          # Cooldown in ms (default: 30000)

# Optional: File downloads
# TELEGRAM_DOWNLOAD_DIR=~/Downloads/telegram-mcp  # Default download directory

# Optional: File upload security
# TELEGRAM_ALLOWED_UPLOAD_DIRS=/home/user/uploads,/tmp/bot-files
# TELEGRAM_MAX_FILE_SIZE=52428800     # Max file size in bytes (default: 50MB)