# Spotify Music MCP

> Spotify Music MCP lets your AI client control Spotify playback, search its entire catalog of millions of tracks, and analyze audio features. Use this to find specific songs, manage playlists on the fly, or get deep data points like a track's tempo and energy level—all through simple conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** music-streaming, audio-analytics, playlist-management, playback-control, media-api

## Description

Your agent can handle all your music needs without you having to switch apps or open the Spotify desktop client. You ask for something—maybe 'Play some high-energy jazz for a study session,' or 'What are the audio features of that new track?'—and this MCP handles the actions, from searching millions of songs to adjusting the playback queue and even analyzing the song’s underlying data. This connection lets you get detailed information about specific artists or albums, build recommendations based on genres, and view all your existing playlists, everything through text prompts. If you're using Vinkius, this MCP gives your AI client immediate access to a massive library of music control tools, turning simple conversation into actual audio commands.

## Tools

### get_album
Retrieves all specific information about a given album.

### get_artist
Gets detailed data for a specified musical artist.

### get_current_track
Pulls the details of whatever song is playing right now on your device.

### search
Searches Spotify's library to find tracks, artists, albums, or playlists.

### get_track
Gets comprehensive data for a specific song.

### get_user_playlists
Lists all the personalized playlists you currently have saved on Spotify.

### get_audio_features
Provides technical metrics like danceability and energy for a specific track.

### get_new_releases
Fetches a list of the newest albums and singles available on Spotify.

### pause
Stops the music playback that is currently running.

### play
Starts or resumes playing music immediately.

### get_playlist
Retrieves details for a single, specific playlist by ID.

### add_to_queue
Adds a specified track to the end of your current listening queue.

### get_recommendations
Generates new music suggestions based on seed artists, genres, or tracks you provide.

## Prompt Examples

**Prompt:** 
```
Play some energetic Jazz for studying.
```

**Response:** 
```
Found some high-energy Jazz tracks. Adding to queue and resuming playback.
```

**Prompt:** 
```
What are the audio features for 'Blinding Lights'?
```

**Response:** 
```
Blinding Lights: Danceability 51%, Energy 73%, Tempo 171 BPM, Valence 33%. It's a very fast, energetic song but with a somewhat melancholic vibe.
```

**Prompt:** 
```
Show me the top 5 new releases.
```

**Response:** 
```
Top New Releases: 1. New Album - Artist A. 2. Single Release - Artist B. 3. EP - Artist C. 4. Album - Artist D. 5. Single - Artist E.
```

## Capabilities

### Search the catalog
Find any track, artist, album, or playlist by name across Spotify's massive database.

### Control playback state
Start playing music, pause the current song, or add tracks directly to your listening queue.

### Analyze song data
Retrieve deep audio metrics for any track, including its danceability, energy level, and tempo.

### Curate playlists
View your existing music libraries or get recommended tracks based on specific artists or moods.

## Use Cases

### Analyzing a mood for a soundtrack
A film editor needs to choose background music. They ask their agent to `search` for tracks tagged 'cinematic.' Then, they use `get_audio_features` on the top three results to compare the tempo and valence scores before picking one.

### Managing a party's music flow
A host asks their agent to check the current track using `get_current_track`. When the song ends, they prompt the agent to add five high-energy songs to the queue using `add_to_queue` and then tell it to resume playback with `play`.

### Building a discovery tool
A user wants to find music similar to their favorite album. They ask the agent to get recommendations using `get_recommendations`, referencing specific artists, and then check out any new drops with `get_new_releases`.

### Curating a themed playlist
A user wants a playlist of 'Rainy Day Chill.' They ask the agent to retrieve their existing playlists using `get_user_playlists`, then use the details from `get_playlist` to ensure the theme is consistent.

## Benefits

- Stop clicking through menus. You can tell your agent to find music, pause it, get its technical data (like tempo), and then resume playback—all in one conversation.
- Need research material? Use the `get_audio_features` tool to instantly pull metrics like energy or danceability for any song, helping you analyze trends without opening a spreadsheet.
- Playlist management gets simple. Instead of manually checking every folder, your agent can use `get_user_playlists` and then `get_playlist` to give you an overview of your entire music library.
- Discovery is instant. Use `search` or `get_recommendations` to find brand new songs tailored exactly to a mood or genre, saving hours of browsing.
- Stay up-to-date with the latest hits. The `get_new_releases` tool pulls fresh album data so you always know what's dropping right now.

## How It Works

The bottom line is you tell your agent what music action you want; it handles the complex calls to Spotify and gives you a result without manual effort.

1. First, subscribe to this MCP and provide your Spotify Access Token in the Vinkius Developer Dashboard.
2. Next, prompt your AI client with a natural language request—for example, 'Find me an upbeat track for running.'
3. Finally, your agent executes the necessary commands, managing playback or returning metadata directly to you.

## Frequently Asked Questions

**How does the Spotify Music MCP work with my existing playlists?**
The MCP can read your library using `get_user_playlists` and pull details on specific lists via `get_playlist`. You don't have to manually check them; just ask your agent what's in your 'Workout Jams' playlist.

**Can I use the Spotify Music MCP to find music for a specific mood?**
Yes. Instead of guessing, you can prompt the MCP to generate suggestions using `get_recommendations`. You just tell it the genre or artist, and it finds tracks that match your desired vibe.

**Is the Spotify Music MCP only for finding songs?**
No. Beyond searching, you can control playback directly. You can ask it to pause music using `pause`, add something to the queue with `add_to_queue`, or start playing a track immediately.

**What kind of data does get_audio_features provide?**
It provides technical metrics like Danceability, Energy, Valence, and Tempo. This is useful for data analysis when you need to quantify how 'happy' or 'fast' a song sounds.

**How do I find the newest songs using the Spotify Music MCP?**
Simply ask your agent to run `get_new_releases`. It pulls the latest albums and singles, keeping you updated on what’s dropping across Spotify.