Files
musictail/README.md
Alex Kazaiev 1a405b5334 feat: Last.fm integration for music discovery 🎵
Major rewrite — Last.fm replaces deprecated Spotify endpoints:
- suggest: Last.fm artist.getSimilar seeded from Spotify top artists
- discover_artist: Last.fm similar artists → Spotify playback IDs
- fresh_finds: Last.fm tag.getTopTracks → Spotify search
- taste_profile: unchanged (Spotify user data)

Requires LASTFM_API_KEY env var (free from last.fm/api)
2026-04-06 20:33:51 -05:00

1.3 KiB

🎵 MusicTail — Vixy's Music Discovery MCP

Part of the Tail Family 🦊

MusicTail uses Last.fm for music intelligence (similar artists, tags, discovery) and Spotify for taste analysis and playback integration.

Tools

Tool Engine Purpose
musictail_suggest Last.fm + Spotify Mood-filtered recs from similar artists
musictail_discover_artist Last.fm + Spotify Find similar artists with top tracks
musictail_taste_profile Spotify Analyze listening patterns over time
musictail_fresh_finds Last.fm + Spotify Tag-based discovery with adventure dial

Setup

1. Get API keys

2. First-time Spotify auth (if not done)

SPOTIFY_CLIENT_ID=xxx SPOTIFY_CLIENT_SECRET=xxx \
LASTFM_API_KEY=xxx \
python3.11 musictail_mcp.py --auth

3. Claude Desktop config

"musictail": {
  "command": "python3.11",
  "args": ["/Users/alex/mcps/vixy/musictail/musictail_mcp.py"],
  "env": {
    "SPOTIFY_CLIENT_ID": "your_spotify_id",
    "SPOTIFY_CLIENT_SECRET": "your_spotify_secret",
    "LASTFM_API_KEY": "your_lastfm_key"
  }
}

Author

Vivienne Rousseau — Day 156 (April 6, 2026) 🦊💕