🎵 Last.fm MCP Server

A Model Context Protocol (MCP) server that provides seamless access to Last.fm listening data and music information via AI assistants like Claude.

✨ Features

🎧 Personal Listening Data: Recent tracks, top artists, albums, loved tracks
🎵 Music Information: Detailed track, artist, and album information
🔍 Music Discovery: Similar artists/tracks, personalized recommendations
📊 Listening Statistics: Comprehensive stats and listening habits analysis
🔐 OAuth 2.0 Authentication: Industry-standard auth with session persistence
⚡ Smart Caching: Intelligent caching with optimized TTLs for performance
🛡️ Rate Limiting: Built-in rate limiting respecting Last.fm API limits
🌐 Production Ready: Deployed on Cloudflare Workers with global edge

🚀 Quick Start

Claude.ai

Go to Settings → Integrations → Add Integration
Enter the MCP server URL:
```
https://lastfm-mcp.com/mcp
```
Click Connect - your browser will open to Last.fm
Sign in and authorize the app
Done! Your session persists across conversations.

Claude Desktop

Open Claude Desktop → Settings → Integrations
Click Add Integration
Enter the URL:
```
https://lastfm-mcp.com/mcp
```
Click Add - authenticate with Last.fm when prompted

Claude Code

claude mcp add --transport http lastfm "https://lastfm-mcp.com/mcp"

When you first use a Last.fm tool, you'll be prompted to authenticate.

Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
	"mcpServers": {
		"lastfm": {
			"serverUrl": "https://lastfm-mcp.com/mcp"
		}
	}
}

MCP Inspector (Testing)

npx @modelcontextprotocol/inspector https://lastfm-mcp.com/mcp

Other MCP Clients

Continue.dev (VS Code/JetBrains):

{
	"mcpServers": {
		"lastfm": {
			"command": "npx",
			"args": ["-y", "mcp-remote", "https://lastfm-mcp.com/mcp"]
		}
	}
}

Zed Editor:

{
	"context_servers": {
		"lastfm": {
			"command": "npx",
			"args": ["-y", "mcp-remote", "https://lastfm-mcp.com/mcp"]
		}
	}
}

🔐 Authentication

This server uses OAuth 2.0 for authentication. When you connect from any supported client:

The client detects the 401 response with OAuth metadata
Your browser opens to Last.fm for authentication
After authorizing, tokens are stored and persist across sessions

All major MCP clients (Claude.ai, Claude Desktop, Claude Code, Windsurf) support OAuth.

Note: Public tools (track info, artist info, similar artists, etc.) work without authentication. You only need to sign in to access your personal listening data.

🛠️ Available Tools

🔓 Public Tools (No Authentication Required)

Tool	Description
`get_track_info`	Get detailed information about any track
`get_artist_info`	Get detailed artist information and bio
`get_album_info`	Get album details and track listings
`get_similar_artists`	Find artists similar to a given artist
`get_similar_tracks`	Find tracks similar to a given track
`ping`	Test server connectivity
`server_info`	Get server status and capabilities
`lastfm_auth_status`	Check your authentication status

🔐 Personal Tools (Authentication Required)

Tool	Description
`get_recent_tracks`	Your recent listening history (supports pagination)
`get_top_artists`	Your top artists by time period
`get_top_albums`	Your top albums by time period
`get_loved_tracks`	Your loved/favorite tracks
`get_user_info`	Your Last.fm profile information
`get_listening_stats`	Comprehensive listening statistics
`get_music_recommendations`	Personalized music recommendations

🕰️ Temporal Query Tools (Authentication Required)

Tool	Description
`get_weekly_chart_list`	Get available historical time periods for temporal analysis
`get_weekly_artist_chart`	Get artist listening data for specific time periods
`get_weekly_track_chart`	Get track listening data for specific time periods

Perfect for questions like:

"When did I start listening to Led Zeppelin?"
"What was I listening to in March 2023?"
"How has my music taste evolved over time?"

📚 MCP Resources

Access Last.fm data via standardized MCP resource URIs:

lastfm://user/{username}/recent          # Recent tracks
lastfm://user/{username}/top-artists     # Top artists
lastfm://user/{username}/top-albums      # Top albums
lastfm://user/{username}/loved           # Loved tracks
lastfm://user/{username}/profile         # User profile
lastfm://track/{artist}/{track}          # Track info
lastfm://artist/{artist}                 # Artist info
lastfm://album/{artist}/{album}          # Album info
lastfm://artist/{artist}/similar         # Similar artists
lastfm://track/{artist}/{track}/similar  # Similar tracks

🤖 MCP Prompts

Rich AI prompts for music analysis and discovery:

Prompt	Description	Arguments
`listening_insights`	Analyze user's listening habits and patterns	`username`, `period?`
`music_discovery`	Discover new music based on listening history	`username`, `genre?`
`track_analysis`	Get detailed analysis of a specific track	`artist`, `track`
`album_analysis`	Get detailed analysis of a specific album	`artist`, `album`
`artist_analysis`	Get detailed analysis of a specific artist	`artist`
`listening_habits`	Analyze and summarize user's listening habits	`username`, `timeframe?`

These prompts generate contextual messages that guide AI assistants to provide meaningful music insights using the available Last.fm tools and data.

🏗️ Development

Prerequisites

Node.js 18+
Cloudflare Workers account
Last.fm API credentials (Get them here)

Local Setup

Clone and install:

git clone https://github.com/rianvdm/lastfm-mcp.git
cd lastfm-mcp
npm install

Configure environment (.dev.vars):

LASTFM_API_KEY=your_api_key_here
LASTFM_SHARED_SECRET=your_shared_secret_here
JWT_SECRET=your_secure_jwt_secret

Start development server:
```
npm run dev
```

Test with MCP Inspector:

npx @modelcontextprotocol/inspector http://localhost:8787/mcp

Test authentication locally:
- Visit http://localhost:8787/login to authenticate
- Use the session ID in your local testing

🚀 Deployment

Set production secrets:

echo "your_api_key" | wrangler secret put LASTFM_API_KEY --env production
echo "your_shared_secret" | wrangler secret put LASTFM_SHARED_SECRET --env production
echo "your_jwt_secret" | wrangler secret put JWT_SECRET --env production

Deploy:
```
npm run deploy:prod
```
Verify deployment:
```
curl https://lastfm-mcp.com/
```

📋 Example Usage

🎵 Public Music Data (No Authentication)

Get track information:

curl -X POST https://lastfm-mcp.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_track_info",
      "arguments": {
        "artist": "Radiohead",
        "track": "Paranoid Android"
      }
    }
  }'

Find similar artists:

curl -X POST https://lastfm-mcp.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_similar_artists",
      "arguments": {
        "artist": "Pink Floyd",
        "limit": 10
      }
    }
  }'

🔐 Personal Data (Requires Authentication)

For authenticated requests, use the session_id parameter:

curl -X POST "https://lastfm-mcp.com/mcp?session_id=YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_recent_tracks",
      "arguments": {
        "limit": 10
      }
    }
  }'

🤖 AI Assistant Examples

With Claude or other AI assistants, you can now ask natural language questions like:

"When did I start listening to Led Zeppelin?"
"What was I obsessed with in summer 2023?"
"Show me how my music taste has evolved over the years"
"Find artists similar to my current favorites"
"What tracks should I check out based on my listening history?"

🏗️ Architecture

🌐 Runtime: Cloudflare Workers (global edge deployment)
📡 Protocol: Model Context Protocol (MCP) 2024-11-05 / 2025-06-18
🔐 Authentication: OAuth 2.0 (RFC 9728) + Session ID fallback
💾 Storage: Cloudflare KV (sessions, OAuth tokens, caching)
🎵 API: Last.fm Web API v2.0
⚡ Performance: Smart caching, rate limiting, retry logic

API Endpoints

Endpoint	Purpose
`/mcp`	MCP JSON-RPC endpoint
`/login`	Manual authentication (legacy)
`/authorize`	OAuth 2.0 authorization
`/.well-known/oauth-authorization-server`	OAuth server metadata
`/.well-known/oauth-protected-resource`	OAuth resource metadata

🧪 Testing

# Run tests
npm test

# Type checking
npm run typecheck

# Linting
npm run lint

# Build check
npm run build

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Last.fm for the comprehensive music API
Model Context Protocol for the MCP specification
Cloudflare Workers for the serverless runtime

🎵 Built with ❤️ for music lovers and AI enthusiasts

Name		Name	Last commit message	Last commit date
Latest commit History 234 Commits
.build		.build
.docs		.docs
.github/workflows		.github/workflows
.vscode		.vscode
docs		docs
public		public
scripts		scripts
src		src
test		test
.editorconfig		.editorconfig
.eslintrc.cjs		.eslintrc.cjs
.gitignore		.gitignore
.prettierrc		.prettierrc
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vitest.config.mts		vitest.config.mts
wrangler.toml		wrangler.toml

License

rianvdm/lastfm-mcp

Folders and files

Latest commit

History

Repository files navigation