dard. Configure your client to: 1. Execute `scrobblercontext-mcp` as the server command 2. Set the required environment variables 3. Use stdio transport ## Usage Examples Authenticate with Last.fm: ``` User: "Authenticate with Last.fm" Assistant: [Uses authenticate_browser tool to start OAuth flow] ``` Search for music: ``` User: "Find artists similar to Radiohead" Assistant: [Uses get_similar_artists tool to find recommendations] ``` Scrobble tracks: ``` User: "Scrobble 'Bohemian Rhapsody' by Queen" Assistant: [Uses scrobble_track tool to submit to your profile] ``` ## Manual Installation **Prerequisites:** - Swift 6.0+ ([Download](https://swift.org/download/)) - macOS 13.0+ or Linux with Swift support - Last.fm API credentials **Build from source:** ```bash git clone https://github.com/tfmart/ScrobblerContext cd ScrobblerContext swift build export LASTFM_API_KEY="your_api_key_here" export LASTFM_SECRET_KEY="your_secret_key_here" swift run ScrobblerContext ``` ## Available Tools

Authentication Tools (5)

- `authenticate_browser` - Start OAuth flow in browser - `set_session_key` - Set existing session key - `check_auth_status` - Check authentication status - `restore_session` - Restore saved session - `logout` - Clear authentication

Artist Tools (9)

- `search_artist` - Search for artists - `get_artist_info` - Get artist details & biography - `get_similar_artists` - Find similar artists - `get_artist_correction` - Get corrected artist name - `get_artist_tags` - Get artist tags - `get_artist_top_albums` - Get artist's top albums - `get_artist_top_tracks` - Get artist's top tracks - `add_artist_tags` - Add personal tags (requires auth) - `remove_artist_tag` - Remove personal tag (requires auth)

Album Tools (6)

- `search_album` - Search for albums - `get_album_info` - Get album details & tracklist - `get_album_tags` - Get album tags - `get_album_top_tags` - Get popular album tags - `add_album_tags` - Add personal tags (requires auth) - `remove_album_tag` - Remove personal tag (requires auth)

Track Tools (8)

- `search_track` - Search for tracks - `get_track_info` - Get track details - `get_similar_tracks` - Find similar tracks - `get_track_correction` - Get corrected track info - `get_track_tags` - Get track tags - `get_track_top_tags` - Get popular track tags - `add_track_tags` - Add personal tags (requires auth) - `remove_track_tag` - Remove personal tag (requires auth)

User Tools (9)

- `get_user_info` - Get user profile & stats - `get_user_recent_tracks` - Get recent listening history - `get_user_top_artists` - Get top artists by period - `get_user_top_tracks` - Get top tracks by period - `get_user_top_albums` - Get top albums by period - `get_user_top_tags` - Get most used tags - `get_user_friends` - Get friends list - `get_user_loved_tracks` - Get loved tracks - `get_user_personal_tags_for_artists` - Get tagged artists

Scrobble Tools (5)

- `scrobble_track` - Submit single track play - `scrobble_multiple_tracks` - Submit multiple plays - `update_now_playing` - Update current track status - `love_track` - Mark track as loved - `unlove_track` - Remove from loved tracks

## Contributing Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ## Documentation - [API Documentation](https://tfmart.github.io/ScrobblerContext/documentation/scrobblercontext/) - Auto-generated from code - [Contributing Guide](CONTRIBUTING.md) - Development setup and guidelines - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification - [Last.fm API](https://www.last.fm/api) - Last.fm API documentation ## Troubleshooting **Swift not found**: Install Swift from [swift.org](https://swift.org/download/) **Invalid session key**:

#lastfm

ScrobblerContext - Last.fm MCP Server