mcp-tg exhibits significant definition quality gaps. Of 10 visible tools, all have descriptions (positive), but descriptions are extremely terse (avg 65 chars, well below 194-char baseline). Schemas are present but minimal: most parameters lack type constraints, enums, or validation guidance. No output schemas documented. Tool names follow verb_noun convention (tg_groups_members_list, tg_messages_send) but lack clarity on parameter semantics (e.g., 'peer' is ambiguous, is it a user ID, channel ID, or username?). No evidence of error handling guidance, recovery paths, or actionable error messages. Security concerns: no visible secret injection pattern despite Telegram API requiring auth tokens. Composition is reasonable (tools are single-purpose), but parameter naming inconsistencies (peer vs group vs user) force LLM reasoning overhead. Per-tool scores average 42, reflecting consistent mediocrity across the board.

• Expand all tool descriptions to 100 - 200 characters. Include WHAT the tool does, WHEN to use it, and what it returns. E.g., 'List all members of a group or channel. Returns member IDs, usernames, and roles. Use this to check group composition before assigning admin privileges.'
• Add type suffixes to all identifier parameters: peer_id, peer_name, group_id, user_id, user_name. Provide separate parameters for ID vs name lookups (e.g., tg_messages_send accepts peer_id OR peer_name, not ambiguous 'peer').
• Document output schemas for all tools. For tg_groups_members_list, specify: returns array of {user_id, username, first_name, last_name, is_admin}. For tg_messages_send, specify: returns {message_id, timestamp, status}.
• Add parameter constraints: 'seconds' in tg_groups_slowmode should specify range (e.g., 0 - 86400); 'parseMode' in tg_messages_send should be an enum (html, markdown, plain). Include these in descriptions, not just schema.
• Implement error handling guidance. E.g., tg_groups_admin_set should document: 'If user not found, try tg_groups_members_list to find valid user IDs. If permission denied, verify caller is group admin.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry