Unofficial Yandex Music integration for Claude Desktop. Wrapper over the yandex-music library (MarshalX/yandex-music-api).
Server has 9 tools with complete input schemas and descriptions in Russian. However, descriptions are terse (avg ~60 chars, well below the 194-char baseline), lack actionable context for LLM selection, and omit prerequisites/dependencies. No output schemas documented. Parameters lack type constraints (enums, ranges). Error handling is minimal, no recovery guidance or categorization. Tools are well-named with action verbs (get_, list_, create_, add_, remove_, like_), but descriptions do not explain WHEN to use each tool or what distinguishes similar operations. No tool annotations (readOnlyHint, destructiveHint). Composition is sound, tools chain via track_id:album_id format, but responses are JSON strings rather than structured objects, forcing LLM parsing.
Проверить подключение: аккаунт, логин, наличие подписки Плюс.
Добавить треки в плейлист (в конец).
Создать новый плейлист.
Получить лайкнутые треки пользователя (Мне нравится).
Треки из плейлиста пользователя.
Поставить лайк трекам (добавить в «Мне нравится»).
Список плейлистов пользователя (kind — это ID плейлиста для других инструментов).
Descriptions are terse (avg 60 chars vs 194-char baseline) and lack actionable context. E.g., 'Получить лайкнутые треки пользователя (Мне нравится)' does not explain WHEN to call this vs get_playlist_tracks, or what the response structure contains.
Output schemas are not documented. Tools return JSON strings (via _dump()) rather than structured objects. LLMs must parse unstructured text, wasting tokens and increasing hallucination risk. No field descriptions for response objects.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Agents cannot distinguish safe reads from destructive writes without parsing descriptions. remove_track_from_playlist and like_tracks should be annotated as WRITE/DESTRUCTIVE.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Удалить трек из плейлиста по позиции (0 — первый трек).
Найти треки в каталоге Яндекс Музыки.
Parameters lack type constraints. 'visibility' in create_playlist accepts free-form strings; should be enum ['private', 'public']. 'limit' and 'offset' lack min/max bounds. LLMs can pass invalid values (negative offsets, absurd limits).
Error handling is minimal. add_tracks_to_playlist catches exceptions but returns raw error strings ('error': str(e)). No recovery guidance, categorization (retryable vs fatal), or actionable next steps for LLM.