# Deezer MCP > Deezer connects your AI agent directly to millions of tracks and the entire Deezer music catalog. Search by genre, discover top artists, look up detailed album tracklists, or analyze global charts—all through natural conversation. It lets you pull structured metadata on playlists and musicians without ever leaving your chat interface. ## Overview - **Category:** audio-music - **Price:** Free - **Tags:** music-streaming, playlist-curation, artist-discovery, audio-metadata, charts ## Description This MCP gives your AI agent immediate access to the massive Deezer music library. You can ask it to find tracks by keywords, check what's trending in a specific country, or research an artist’s top songs and associated radio stations. If you need to build content around musical data—whether that's for journalism, marketing campaigns, or simply planning a concert setlist—this tool gathers all the necessary metadata instantly. You can search deep into public playlists by mood or genre, find album details including release dates, or browse entire music genres to discover curated lists. Because Vinkius hosts this catalog, you connect your preferred AI client once and get full read access to Deezer's vast database of audio information. ## Tools ### get_genre Provides structured information about different musical genres available on Deezer. ### get_playlist Gets detailed metadata for a specific playlist, including its creator and track count. ### get_album Retrieves detailed information about a specific musical album. ### get_album_tracks Lists all the individual tracks contained within an album. ### get_artist_radio Gets a selection of radio tracks curated for a specific artist's sound. ### search_albums Searches the catalog to find albums based on titles or artists, returning cover art info. ### search_artists Searches for musicians and returns profile details like fan count and album count. ### search_playlists Finds playlists by searching criteria, listing the creator and number of tracks in each. ### search_tracks Searches for individual songs using keywords or partial titles, providing preview links. ### get_artist Retrieves comprehensive profile data about a musician or group. ### get_artist_top_tracks Fetches the most popular songs associated with a given artist. ### get_chart Accesses Deezer's charts, allowing you to filter results by country code. ### get_genre_playlists Finds public playlists that are specifically tied to a given music genre. ### get_track Retrieves complete details on a single song, such as duration and artist information. ## Prompt Examples **Prompt:** ``` Search for songs by Daft Punk. ``` **Response:** ``` Found 25 Daft Punk tracks. Top results: 'Get Lucky' (feat. Pharrell Williams, 6:09), 'One More Time' (5:20), and 'Harder Better Faster Stronger' (3:45). Want their top 10 tracks? ``` **Prompt:** ``` What's trending in Brazil right now? ``` **Response:** ``` Brazil's top tracks: #1 'Barulho do Foguete' by Zé Neto & Cristiano, #2 'Oi Balde' by Henrique & Juliano. Top album: 'Nosso Quadro' by Ana Castela. Would you like the full top 10? ``` **Prompt:** ``` Find me chill playlists for studying. ``` **Response:** ``` Found 5 chill study playlists: 'Chill Study' (120 tracks, 45K fans), 'Lo-Fi Beats' (85 tracks), 'Peaceful Piano' (200 tracks). The top one has a great mix of ambient and lo-fi. ``` ## Capabilities ### Find specific songs Search the entire library for tracks using keywords or artist names, getting details and preview links. ### Analyze artists and albums Get detailed profiles on musicians, view their top tracks, and look up full album listings with release dates. ### Curate playlists by theme or mood Search existing public playlists based on a genre, mood, or curator, and explore deep genre categories. ### Check global music trends View the current top songs, albums, and artists for any region using international country codes. ## Use Cases ### Researching emerging musical trends A marketing analyst needs to know what sounds are hot in Southeast Asia. They ask their agent for 'global charts' filtered by the country code and use get_artist_top_tracks to see which specific artists dominate that market right now. ### Creating a themed content calendar A journalist needs source material about 90s alternative rock. They ask their agent to search for playlists by genre, then use get_album details on the resulting albums to pull out specific release dates and track counts. ### Building an educational resource guide A university professor is teaching music history. Instead of manually checking album data, they ask their agent to search for artists and then use get_genre information to provide students with structured context on musical movements. ### Debugging a missing song link A web developer needs to verify if a track exists before building an embed. They run 'search tracks' using the exact title and artist name, getting immediate confirmation and preview links for validation. ## Benefits - You stop manual searching. Instead of checking the Deezer website for top tracks, you simply ask your agent what's trending in Brazil, and it gives you a ranked list instantly. - Get deep artist context fast. Instead of clicking through multiple pages to learn about an artist's career, use the MCP to get their profile, top tracks, and associated radio stations all at once. - Curate without clicks. Need study music? Search for playlists by mood or genre (like Lo-Fi Beats) and retrieve structured data listing track counts and fan metrics. - Build comprehensive metadata reports. You can use the MCP to get detailed album information, including release dates and full track listings, which is perfect for research. - Manage complex searches easily. If you're looking for a specific song by title or keyword, the dedicated search_tracks tool gives you immediate results with preview links. ## How It Works The bottom line is, you use natural conversation to pull complex music metadata from Deezer directly into your workflow. 1. Subscribe to this MCP on Vinkius. You don't need an API key because Deezer provides open read access. 2. Activate the tool within your AI client, like Cursor or Claude. 3. Ask a natural language question, such as 'What are the top songs in Brazil right now?' and receive structured data. ## Frequently Asked Questions **Can I use the Deezer MCP to find music genres?** Yes, you can get genre information using the get_genre tool. This provides structured details about various musical categories for your research. **How do I find out what's trending in a specific country with Deezer MCP?** You use the get_chart tool and pass the desired country using its ISO 3166-1 code. This allows you to see regional top tracks, albums, or artists. **Does search_tracks provide just titles, or more detail?** The search_tracks tool returns detailed information for each song found, including the artist, album name, duration, and a preview link for verification. **What if I want to know about an album's full tracklist?** You first use get_album to find the album metadata, then run get_album_tracks using that result. This gives you every song on the record. **Is Deezer MCP suitable for building playlists?** The tool is excellent for gathering playlist data via search_playlists and getting details with get_playlist. It provides the metadata needed to build your structure, but it doesn't create the playlist itself. **Do I need a Deezer account or API key to use this?** No! The Deezer public API is open for reading without authentication. You can search tracks, artists, albums, playlists, and charts immediately. **Can I listen to song previews?** Yes! Every track returned by the search includes a 30-second preview URL that you can play directly in your browser. **Can I get charts for a specific country?** Yes! Use the `get_chart` tool with a country code (e.g., US, BR, FR, DE) to get the top tracks, albums, artists, and playlists for that region.