Yandex Music MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_MUSIC_TOKEN | No | Yandex Music OAuth token (optional; by default read from ~/.yandex-music-mcp/token created by yandex-music-mcp-auth) | |
| YANDEX_MUSIC_EXPORT_DIR | No | Folder for .txt/.csv exports (default: Documents/Yandex Music exports) | |
| YANDEX_MUSIC_TOKEN_FILE | No | Path to the token file, if not in the default location |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| account_infoA | Проверка подключения: логин, имя и статус подписки Плюс. |
| searchB | Поиск по каталогу Яндекс Музыки. type сужает поиск; limit — сколько результатов в каждой категории. |
| get_liked_tracksA | Треки из «Мне нравится», от последних лайков к старым, с датой лайка (liked_at). Для анализа вкуса бери limit побольше (до 500). |
| get_listening_historyB | Недавно прослушанные треки (история прослушиваний), сгруппированные по дням. |
| list_my_playlistsA | Все мои плейлисты (kind — идентификатор плейлиста для других инструментов). |
| get_playlist_tracksB | Треки плейлиста. По умолчанию — мой плейлист; owner_uid — для чужого публичного. |
| get_album_tracksC | Информация об альбоме и его треклист. |
| get_playlist_by_urlA | Треки по ссылке на Яндекс Музыку — в том числе чужого публичного плейлиста. Понимает ссылки вида music.yandex.ru/users/<логин>/playlists/<номер>, music.yandex.ru/playlists/ (новый формат, в т.ч. lk.…) и ссылки на альбом /album/. Подходит любой домен Яндекс Музыки (.ru, .com, .by, .kz и т.д.). |
| get_artist_tracksC | Популярные треки артиста. |
| get_similar_tracksB | Похожие треки по версии Яндекса (track_id в формате "123" или "123:456"). |
| get_my_waveA | Порция треков из «Моей волны» — персональных рекомендаций. batches — сколько порций (≈5 треков каждая). |
| get_chartC | Текущий чарт Яндекс Музыки. |
| export_tracks_to_fileA | Выгружает ВСЕ треки (лайки или плейлист) в текстовые файлы на компьютер, не загружая их в чат: .txt («Исполнитель — Название», по строке) и .csv (с альбомом, годом, жанром, id; для лайков — дата лайка). Файлы кладутся в «Документы/Yandex Music exports» (или в YANDEX_MUSIC_EXPORT_DIR). Для source="playlist" нужен kind. |
| create_playlistB | Создаёт новый плейлист (по умолчанию приватный). Возвращает его kind. |
| add_tracks_to_playlistC | Добавляет треки в мой плейлист. track_ids — id из других инструментов ("123:456" или "123"). |
| remove_tracks_from_playlistC | Удаляет указанные треки из моего плейлиста. |
| delete_playlistA | НЕОБРАТИМО удаляет мой плейлист целиком. Перед вызовом обязательно спроси пользователя. confirm_title — точное название удаляемого плейлиста (защита от удаления не того плейлиста). |
| like_tracksC | Ставит лайк («Мне нравится») трекам. |
| unlike_tracksC | Убирает треки из «Мне нравится». |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Most tools target a clearly distinct resource+action pair: liked tracks, charts, playlists, albums, artists, search, history, wave, and export are all separable. The only real friction is between get_playlist_tracks, get_playlist_by_url, and get_album_tracks, where the same content can be reached via id, owner_uid, or URL — descriptions mostly resolve this but an agent may still hesitate on which entry point to use.
Strong consistent snake_case verb_noun pattern across nearly all tools (get_liked_tracks, create_playlist, add_tracks_to_playlist, export_tracks_to_file, list_my_playlists). Two deviations break it: bare 'search' and the noun-phrase 'account_info' (would be get_account_info / search_catalog), plus a couple of prepositional variants.
At 19 tools the set is on the heavier side but each tool maps to a concrete capability of the music service, with no filler or near-duplicates. Nothing feels padded, though it brushes the upper bound of easy scannability for an agent.
Playlist lifecycle is largely covered (create, list, get tracks, add/remove tracks, delete, export) alongside liked tracks, search, charts, history, and radio-style discovery. Gaps are minor: no playlist rename/edit (title, description, cover), no direct get_track_by_id for track-level metadata, and no liked-albums/artists management.