MCP Server

Connect AI assistants like Claude to your Raygum account to search music, manage playlists, and get personalized recommendations.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely connect to external services. Raygum's MCP server lets you use natural language to interact with your music library through AI tools like Claude Desktop.

What Can You Do?

Search Music:Ask Claude to find artists, albums, or tracks in Raygum's database
Get Release Details: Get full information about an album including tracklist, genres, and credits
Discover Similar Music: Find releases similar to ones you love based on genre and musical characteristics
Get Recommendations: Ask for personalized music recommendations by genre
Manage Playlists: Create, edit, and organize playlists directly through conversation

Getting Started

1. Create an API Token

Go to Settings → API Tokens and create a new token. Give it a memorable name like "Claude Desktop". Copy the token immediately - you won't be able to see it again.

2. Configure Claude Desktop

Open your Claude Desktop configuration file and add the Raygum MCP server:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "raygum": {
      "url": "https://mcp.raygum.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the configuration, restart Claude Desktop. You should see Raygum listed as an available MCP server.

4. Start Using It

Try asking Claude things like:

"Search for albums by Radiohead"
"Get details about OK Computer"
"Find releases similar to Kid A"
"Create a new playlist called 'Chill Vibes'"
"Add these tracks to my playlist"

Available Tools

search_releases

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

search_artists

Search for artists by name

search_tracks

Search for tracks by title or artist

get_release

Get full details for a release including tracklist and genres

get_artist

Get artist biography, genres, and discography

get_similar_releases

Find releases similar to a given album

get_recommendations

Get recommended releases, optionally filtered by genre

create_playlist

Create a new playlist on your Raygum account

add_tracks_to_playlist

Add tracks to one of your playlists

list_my_playlists

List all playlists on your account

Rate Limits

To ensure fair usage, the MCP server has the following rate limits per user:

Operation	Limit
Search operations	100 per minute
Entity retrieval	200 per minute
Recommendations	30 per minute
Playlist modifications	20 per minute

Security

API tokens are stored as secure hashes - we never store the raw token
Each token is tied to your account and can only access your data
You can revoke tokens at any time from Settings → API Tokens
Tokens can be named to help you track which applications are using them

Need Help?

Having trouble setting up the MCP server? Send us feedback and we'll help you get connected.