yt-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YTMUSIC_OAUTH_FILE | No | Absolute path to the OAuth token file (oauth.json) used for authenticated YouTube actions. | |
| YTMUSIC_OAUTH_CLIENT_ID | No | OAuth client ID, used as an alternative to YTMUSIC_OAUTH_CLIENT_FILE. | |
| YTMUSIC_OAUTH_CLIENT_FILE | No | Absolute path to the OAuth client JSON file (oauth-client.json). | |
| YTMUSIC_OAUTH_CLIENT_SECRET | No | OAuth client secret, used as an alternative to YTMUSIC_OAUTH_CLIENT_FILE. |
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 |
|---|---|
| search_songsC | Find songs with IDs, artists, album titles, durations, and links. |
| get_song_radioB | Get YouTube Music's ordered radio recommendations around the first song match. |
| get_multi_seed_radioA | Round-robin two to ten song radios into one deduplicated result. |
| create_private_radio_playlistB | Create a private playlist from a fresh song-radio queue in the connected account. |
| create_private_multi_seed_radio_playlistB | Create one private playlist from a fresh two-to-ten-seed radio mix. |
| resume_private_playlistB | Resume one exact saved track plan; do not invoke concurrently. |
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 6 tools
Each tool targets a distinct action: searching, generating a single-seed radio, creating a playlist from that radio, generating a multi-seed radio, creating a playlist from a multi-seed radio, and resuming an existing playlist. Though some tools pair as get/create for the same seed type, the names and intended step in the workflow are clear.
All tools follow a consistent snake_case verb_noun pattern: search_songs, get_song_radio, create_private_radio_playlist, get_multi_seed_radio, create_private_multi_seed_radio_playlist, resume_private_playlist. The prefix clearly distinguishes action and the noun hierarchy is logical.
Six tools are well-scoped for a YouTube Music radio playlist server. There are enough tools to cover the basic discovery and playlist creation flow without overwhelming the agent, and each tool contributes a meaningful operation.
The surface covers search, radio creation (single and multi-seed), playlist creation from both, and resuming a saved track plan, which supports the core workflow end-to-end. Minor gaps exist—such as no explicit update or delete playlist operations—but they are outside the apparent main purpose and can be worked around by re-creating.