Search songs and make, edit and share music playlists on great.dj. Works without an account.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Your Great DJ API key (great.dj, log in, then 'API key' in the user menu) for playlists in your account. Leave empty to make anonymous public playlists.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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 search_songs and earlier calls instead of looking songs up again. For your own playlists (API key), anonymous ones you made (edit_token), and open ones anyone can edit.
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 search_songs and earlier calls instead of looking songs up again. At most 100 per call.
The playlist's id ("abc123" or "username/abc123") or its great.dj link
The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http greatdj https://api.great.dj/mcp
Headers
Authorization (optional, not in the config above): Optional. Your Great DJ API key (great.dj, log in, then 'API key' in the user menu) for playlists in your account. Leave empty to make anonymous public playlists.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 search_songs and earlier calls instead of looking songs up again. For your own playlists (API key), anonymous ones you made (edit_token), and open ones anyone can edit.
| Argument | Type | Description |
|---|---|---|
| songs* | array | 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 search_songs and earlier calls instead of looking songs up again. At most 100 per call. |
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
| edit_token | string | The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist",
"songs"
],
"properties": {
"songs": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "\"Artist - Title\", looked up on YouTube"
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$",
"description": "YouTube video id (11 characters)"
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Title to show (YouTube's when missing)"
}
},
"description": "A YouTube video, by id",
"additionalProperties": false
}
]
},
"maxItems": 100,
"minItems": 1,
"description": "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 search_songs and earlier calls instead of looking songs up again. At most 100 per call."
},
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
},
"edit_token": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists."
}
},
"additionalProperties": false
}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 exact) or an "Artist - Title" string, looked up on YouTube (slow, and limited per hour). Reuse the video ids returned by search_songs and earlier calls instead of looking songs up again. With an API key it belongs to the key's account. Without one it's an anonymous public playlist and the result has an edit_token: keep it for the rest of the conversation, it's the only way to change the playlist later and can't be recovered.
| Argument | Type | Description |
|---|---|---|
| songs* | array | 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 search_songs and earlier calls instead of looking songs up again. At most 100 per call. |
| title* | string | The playlist's title |
| private | boolean | true (default with an API key): only the owner can edit it; false: anyone can. Anyone with the link can listen either way. true needs an API key. |
| description | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title",
"songs"
],
"properties": {
"songs": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "\"Artist - Title\", looked up on YouTube"
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$",
"description": "YouTube video id (11 characters)"
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Title to show (YouTube's when missing)"
}
},
"description": "A YouTube video, by id",
"additionalProperties": false
}
]
},
"maxItems": 100,
"minItems": 1,
"description": "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 search_songs and earlier calls instead of looking songs up again. At most 100 per call."
},
"title": {
"type": "string",
"maxLength": 50,
"description": "The playlist's title"
},
"private": {
"type": "boolean",
"description": "true (default with an API key): only the owner can edit it; false: anyone can. Anyone with the link can listen either way. true needs an API key."
},
"description": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist"
],
"properties": {
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist"
],
"properties": {
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
}
},
"additionalProperties": false
}great.dj's popular playlists right now (title, owner, link, track count; no tracks: use get_playlist for those).
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | The Spotify playlist's link (https://open.spotify.com/playlist/...) |
| title | string | Title (default "Spotify import") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The Spotify playlist's link (https://open.spotify.com/playlist/...)"
},
"title": {
"type": "string",
"maxLength": 50,
"description": "Title (default \"Spotify import\")"
}
},
"additionalProperties": false
}The playlists of the API key's account, newest first, 20 per page (no tracks: use get_playlist for those). Needs an API key.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page, from 1 (default 1) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page, from 1 (default 1)"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
| edit_token | string | The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist"
],
"properties": {
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
},
"edit_token": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| version* | string | A version id from playlist_history |
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
| edit_token | string | The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist",
"version"
],
"properties": {
"version": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "A version id from playlist_history"
},
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
},
"edit_token": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists."
}
},
"additionalProperties": false
}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 uses up song lookups (limited per hour), so search only for songs you need.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many matches (1 to 3, default 3) |
| query* | string | What to search for, ideally "Artist - Title" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "How many matches (1 to 3, default 3)"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "What to search for, ideally \"Artist - Title\""
}
},
"additionalProperties": false
}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 playlist_history). 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 search_songs and earlier calls instead of looking songs up again. Title, description and privacy: owner only (API key, or edit_token for anonymous playlists). Songs: also anyone, for open playlists.
| Argument | Type | Description |
|---|---|---|
| songs | array | The new full list, replacing the current one. 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 search_songs and earlier calls instead of looking songs up again. At most 500. |
| title | string | |
| private | boolean | true: only the owner can edit it; false: anyone can |
| playlist* | string | The playlist's id ("abc123" or "username/abc123") or its great.dj link |
| edit_token | string | The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists. |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.
| description |
| string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"playlist"
],
"properties": {
"songs": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "\"Artist - Title\", looked up on YouTube"
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$",
"description": "YouTube video id (11 characters)"
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Title to show (YouTube's when missing)"
}
},
"description": "A YouTube video, by id",
"additionalProperties": false
}
]
},
"maxItems": 500,
"minItems": 1,
"description": "The new full list, replacing the current one. 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 search_songs and earlier calls instead of looking songs up again. At most 500."
},
"title": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"private": {
"type": "boolean",
"description": "true: only the owner can edit it; false: anyone can"
},
"playlist": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The playlist's id (\"abc123\" or \"username/abc123\") or its great.dj link"
},
"edit_token": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The edit_token create_playlist returned for an anonymous playlist (made without an API key). Not needed for your own account's playlists."
},
"description": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
}