MCP server for Telegram — connect Claude to your real Telegram account via User API (MTProto)
Critical gaps across all dimensions. Only 2 of 8 tools have visible input schemas (tg_dialogs, tg_draft). Six tools (tg_me, tg_history, tg_search, tg_send, tg_forward, tg_mark_read) show empty Input: {} in tools.go with no schema visible in provided source. Tool descriptions are present but minimal (10-60 chars, well below 50-200 char LLM-optimized baseline). No output schemas documented. Parameter descriptions missing for most tools. No error recovery guidance. Naming follows verb_noun pattern (positive), but schema and description quality are severely deficient.
List Telegram dialogs (only whitelisted chats). Returns ref, type, title, and unread count.
Save a draft message in a whitelisted chat. Does NOT send the message.
Six of eight tools have no visible input schema (tg_me, tg_history, tg_search, tg_send, tg_forward, tg_mark_read show empty Input: {} with no parameter definitions in provided source).
Six tools lack descriptions entirely (tg_me, tg_history, tg_search, tg_send, tg_forward, tg_mark_read).
tg_dialogs and tg_draft descriptions are 10-60 characters, below the 50-200 char LLM-optimized baseline. Descriptions lack WHEN to use, WHAT it returns, and prerequisites. Example: 'List Telegram dialogs (only whitelisted chats)' omits return structure and when to call it.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 32 | <=2025-11-25 | v2 |
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields. tg_dialogs should document it returns array of {ref, type, title, unread_count}; tg_send should document return structure (message_id, timestamp, etc.).
No error handling guidance. Tools like tg_send and tg_forward (WRITE operations) have no documented error recovery paths. LLM cannot distinguish retryable errors from user-fixable ones. Missing pattern: 'If chat not found, call tg_dialogs() to list available chats.'