Model Context Protocol

Give your AI an ear for music.

Search artists, inspect releases, follow musical threads, work through your Listen List, rate records, keep notes, and manage playlists without leaving Codex, Claude Code, or another MCP client.

Connect a client See setup commands

Streamable HTTP endpoint

https://mcp.raygum.com

Access

Start public. Sign in when it gets personal.

Catalogue tools are open to every client. When you ask for your personal library, a compatible client opens Raygum's secure OAuth sign-in and consent screen automatically.

No account needed

Public catalogue

Search music, read public data, inspect tracklists and get recommendations with only the endpoint.

OAuth 2.1

Your music library

Sign in to Raygum, approve the client, then work with your Listen List, ratings, notes, private playlists, and playlist changes. No token copying required.

You stay in control.

Raygum never shares your password. Review permissions before connecting and revoke any client later from Settings.

Manage connected clients

Connect

Add one endpoint, then authenticate.

OAuth-capable clients discover Raygum's sign-in flow automatically. Public tools work immediately; authenticate now or wait until you first use a personal-library tool.

OpenAI

Codex

Add the remote server, then let Codex open Raygum in your browser. The CLI, IDE extension, and desktop app share the connection.

Shellready to paste

codex mcp add raygum --url https://mcp.raygum.com
codex mcp login raygum

Codex MCP documentation

Anthropic

Claude Code

Add the HTTP server at its root URL and choose Raygum's authentication action when prompted.

Shellready to paste

claude mcp add --transport http --scope user raygum https://mcp.raygum.com

Claude Code MCP documentation

Hosted connector

Claude and Claude Desktop

Go to Customize → Connectors, choose Add custom connector, and enter the endpoint. Choose Connect or Authenticate to grant personal-library access.

Raygum uses the standard browser-based OAuth flow, so your password and access token never need to be pasted into Claude.

Claude connector documentation

Streamable HTTP

Other MCP clients

Some clients call this transport http. Add the endpoint; clients that implement MCP authorization discover OAuth automatically.

MCP configurationready to paste

{
  "mcpServers": {
    "raygum": {
      "type": "streamable-http",
      "url": "https://mcp.raygum.com"
    }
  }
}

Manual fallback

Using a script or an older client?

Create a personal token in Settings, store it in an environment variable, and send it as a Bearer token. OAuth is safer and easier for interactive clients.

Shellready to paste

export RAYGUM_MCP_TOKEN='rg_mcp_your_token_here'

~/.codex/config.toml fallbackready to paste

[mcp_servers.raygum]
url = "https://mcp.raygum.com"
bearer_token_env_var = "RAYGUM_MCP_TOKEN"

Try it

Ask for music in plain English.

Once the server is connected, your assistant chooses the right Raygum tool for the job.

“Search Raygum for albums by Radiohead.”

“Show me the tracklist and genres for OK Computer.”

“Find releases similar to Kid A.”

“Recommend five jazz releases from the catalogue.”

“What is on my Listen List?”

Sign-in required

“Rate Dummy by Portishead five stars.”

Sign-in required

“Save this thought as my note on Dummy.”

Sign-in required

“Create a private playlist called Late Night.”

Sign-in required

“Add these tracks to my Late Night playlist.”

Sign-in required

Tools

Twenty-three ways into Raygum.

Eight tools explore the public catalogue. Fifteen authenticated tools work with your Listen List, ratings, notes, and playlists.

Catalogue and discovery

8 public tools

search_releases

Search albums, EPs, and singles by title or artist.

search_artists

Search artists by name.

search_tracks

Search tracks by title or artist.

get_release

Get release metadata, genres, artwork, and the full tracklist.

get_artist

Get an artist biography, genres, artwork, and discography.

get_playlist

Read a public playlist, or a private playlist you own.

get_similar_releases

Find releases with related genres and characteristics.

get_recommendations

Get catalogue recommendations, optionally by genre.

Listen, rate, and note

9 personal tools

list_my_listen_list

List releases waiting on your Listen List.

add_release_to_listen_list

Save a release to hear later.

remove_release_from_listen_list

Remove a release from your Listen List.

list_my_release_ratings

List your recent whole-star release ratings.

rate_release

Set a release rating from one to five stars.

remove_release_rating

Remove a rating without deleting its note.

list_my_release_notes

List your published notes and private drafts.

save_release_note

Create or update a Markdown note, optionally with a rating.

delete_release_note

Delete a note without removing its release rating.

Playlist management

6 personal tools

create_playlist

Create a playlist in your Raygum account.

update_playlist

Change a playlist title, description, or visibility.

add_tracks_to_playlist

Add one or more Raygum tracks to a playlist.

remove_tracks_from_playlist

Remove tracks from one of your playlists.

delete_playlist

Delete a playlist you own.

list_my_playlists

List playlists owned by your account.

Resources

Context you can open

Browse a catalogue guide, release, artist, and playlist URI templates, plus signed-in snapshots of your Listen List, ratings, and notes.

Prompts

Four guided workflows

Discover music, explore a release, work through your Listen List, or capture a rating and note with deliberate confirmation before changes.

Completions

Faster argument entry

Compatible clients can complete genres, releases, artists, and your playlist IDs as you fill prompt and resource arguments.

Reference

Limits and security.

Rate limits

Limits apply per authenticated user or anonymous client address.

Operation	Per minute
Search	100
Entity retrieval	200
Recommendations	30
Listen List, rating, and note changes	30
Playlist changes	20

Access safety

OAuth clients never receive your Raygum password.
Listen Lists, ratings, notes, and private playlist data are restricted to their owner.
Connected clients can be revoked at any time from Settings.
OAuth access is short-lived and refresh tokens rotate automatically.

Troubleshooting

Connected, but not quite working?

Personal tools fail

Open your client's MCP settings and authenticate Raygum again. In Codex, run codex mcp login raygum. If you disconnected the client in Raygum Settings, a fresh approval is required.

Test the public connection

Ask the official MCP Inspector.

This command connects without a token and asks Raygum to list its tools.

Shellready to paste

npx -y @modelcontextprotocol/inspector@latest --cli \
  https://mcp.raygum.com --transport http --method tools/list

Still stuck?

Send the client name and connection error—never your token.

Send feedback