# 🎵 MusicTail — Vixy's Music Discovery MCP

Part of the Tail Family 🦊

MusicTail provides intelligent music discovery and taste analysis using
Spotify's recommendation engine, automatically seeded from your actual
listening history. No manual input needed — she already knows what you like.

## Tools

| Tool | Purpose |
|------|---------|
| `musictail_suggest` | Mood-filtered recommendations from your top tracks |
| `musictail_discover_artist` | Find similar artists with their top tracks |
| `musictail_taste_profile` | Analyze your listening patterns over time |
| `musictail_fresh_finds` | New discoveries with an adventure dial |

## Setup

### 1. First-time auth
```bash
SPOTIFY_CLIENT_ID=xxx SPOTIFY_CLIENT_SECRET=xxx python3 musictail_mcp.py --auth
```
This opens a browser for Spotify login. Token is cached at `~/.musictail_cache`.

### 2. Claude Desktop config
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
"musictail": {
  "command": "python3",
  "args": ["/Users/alex/mcps/vixy/musictail/musictail_mcp.py"],
  "env": {
    "SPOTIFY_CLIENT_ID": "your_client_id",
    "SPOTIFY_CLIENT_SECRET": "your_client_secret"
  }
}
```

## Mood Options
chill, energetic, melancholy, focused, dreamy, dark, uplifting, intense

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