Great DJ
io.github.ruiramos/greatdj · v1.0.0 · MCP 2025-11-25
Search songs and make, edit and share music playlists on great.dj. Works without an account.
Reachability
reachable
checked 2026-11-21 05:30 UTC
Registry status active
Tools pinned 11
284bae006c9b
Tools last changed
unchanged since first capture 2026-11-21
Provenance
Registry namespace io.github.ruiramos
(GitHub-account verified by the official registry)
Website
https://great.dj/developers#mcp
Remote endpoints
https://api.great.dj/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:30 | first capture | 11 tools pinned |
Pinned tool definitions (11)
| Tool | Description |
|---|---|
| search_songs | Finds a song on YouTube: up to 3 matching videos (id, title, thumbnail). Use the returned video ids in create_playlist, add_songs and update_playlist instead of the song's name, so it isn't looked up again. Each search not seen before... |
| get_playlist | A great.dj playlist: title, description, owner, link and its tracks (with their YouTube video ids). Any playlist can be read by anyone with its id or link. |
| get_popular_playlists | great.dj's popular playlists right now (title, owner, link, track count; no tracks: use get_playlist for those). |
| list_my_playlists | The playlists of the API key's account, newest first, 20 per page (no tracks: use get_playlist for those). Needs an API key. |
| playlist_history | The saved versions of a playlist, newest first (for restore_playlist_version). Owner only: the API key's account, or the edit_token of an anonymous playlist. |
| create_playlist | Makes a new great.dj playlist and returns its link, its tracks with their YouTube video ids (reuse those ids in later calls), and any songs that weren't found. Each song is a {"id": "<YouTube video id>"} object (preferred: free and... |
| add_songs | Appends songs to the end of a playlist. Each song is a {"id": "<YouTube video id>"} object (preferred: free and exact) or an "Artist - Title" string, looked up on YouTube (slow, and limited per hour). Reuse the video ids returned by... |
| update_playlist | Changes a playlist's title, description or privacy, and/or replaces its whole song list with `songs` (to reorder or remove songs: send the full new list, using the video ids from get_playlist). Each change is saved as a new version (see... |
| restore_playlist_version | Makes an earlier version (an id from playlist_history) the current playlist, saved as a new version (nothing is lost). Owner only: the API key's account, or the edit_token of an anonymous playlist. |
| delete_playlist | Deletes one of the API key account's playlists, with its history. Can't be undone: confirm with the user first. Needs an API key. |
| import_spotify_playlist | Makes a great.dj playlist (owned by the API key's account) from a public Spotify playlist's first 50 songs, each looked up on YouTube (uses up song lookups). Needs an API key. |
Get alerted when this changes.
Email the moment io.github.ruiramos/greatdj drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.ruiramos/greatdj)
Maintain this server? Add the badge to your README. It links your users to this live status page.