Local stdio MCP server exposing MAX messenger (user session) to Claude Code
8 tools with complete JSON schemas and parameter descriptions, but significant gaps in tool-level descriptions and error handling. All tools have input schemas with proper types. Tool descriptions are present but brief (avg ~60 chars, below 194-char baseline). No output schemas documented. No error recovery guidance. No tool annotations (readOnlyHint/destructiveHint). Naming is clear and verb-based (list_, get_, read_, search_, send_, dump_). Parameters are well-typed with defaults and constraints (limits, pagination). However, descriptions lack LLM-optimization guidance (e.g., 'Получить публикации канала' is Russian and minimal; no 'when to use' or 'what it returns'). send_message and send_file lack confirmation/dry-run patterns despite being destructive. No documented output structure for any tool.
Выгрузить до 1000 публикаций канала с поддержкой продолжения выгрузки.
Получить сведения об одном чате или канале MAX по его id.
Получить публикации канала; before_time листает историю назад.
Получить список чатов MAX с курсорной пагинацией через marker.
Прочитать историю чата; before_time листает историю назад.
Искать подстроку локальным проходом по истории указанного чата.
Отправить файл, фото или видео из разрешённого локального каталога.
Tool descriptions are minimal (avg 60 chars) and in Russian, lacking English LLM-optimization. No 'when to use' guidance or output structure documentation. Descriptions should be 50-200 chars in English with clear intent signals.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., chat_id for send_message). Each tool must declare its return structure.
Destructive tools (send_message, send_file) lack confirmation/dry-run patterns. Agents can send messages or files without verification, risking unintended side effects. Implement confirmation_required or dry_run parameter.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Отправить текстовое сообщение или ответ на указанное сообщение MAX.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) present. LLMs cannot distinguish safe read-only tools from destructive ones without explicit hints. Add tool annotations per MCP spec.
No error recovery guidance. Tools lack descriptions of failure modes, retryability, or next steps. E.g., 'chat_id not found' should suggest list_chats() or get_chat() as recovery.