# Jamendo MCP > Jamendo lets your AI client search and stream independent music from the Jamendo catalog. You can find specific background tracks, discover artists by location, or build curated playlists using natural conversation. It's designed for content creators and developers who need deep metadata access to royalty-free audio. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** music-api, independent-music, audio-streaming, track-discovery, artist-search ## Description Running into a blank spot on your video timeline? This MCP connects your AI agent directly to the massive Jamendo music library. Instead of opening tabs and manually running searches, you just talk to it. You can ask your agent to find high-speed instrumental tracks tagged 'sci-fi,' or locate artists who live in Berlin. It pulls detailed metadata on albums—like geographical origins and community reviews—so you know exactly what you're working with. If you need music for a project, the AI acts like an embedded music supervisor right inside your workflow. We put this connector in Vinkius so that whether you use Claude, Cursor, or any other MCP-compatible client, the power of Jamendo is always available through chat. ## Tools ### get_album_reviews Allows browsing and filtering of community reviews written for an album. ### get_album_tracks Pulls a list of tracks that belong to a specific, identified album. ### search_albums Searches and filters the entire catalog of albums by name or genre. ### get_artist_albums Retrieves all albums associated with a given artist ID. ### get_artist_locations Filters and finds artists based on their recorded geographical location. ### get_artist_tracks Retrieves all tracks that are credited to a specific artist ID. ### search_artists Searches and filters artists based on their name, genre, or location. ### autocomplete_search Suggests possible matches for tracks, albums, artists, or tags as you type. ### get_feeds Fetches editorial content and news articles from the Jamendo homepage feed. ### get_playlist_tracks Retrieves every track that is currently included in a specific playlist ID. ### search_playlists Searches and filters public or private user playlists. ### get_radio_stream Gets the stream URL and information about what is playing on a radio station. ### list_radios Lists all available public radio stations hosted on Jamendo. ### set_user_dislike Marks a specific track as disliked for your user profile. ### set_user_fan Makes your account an official fan of a listed artist. ### set_user_favorite Adds a specific track to your personal list of favorites. ### set_user_like Marks a specific track as liked for your user profile. ### set_user_playlist Creates or updates a playlist, adding tracks to it in bulk. ### get_similar_tracks Finds tracks that are stylistically or tempo-wise similar to one you already know by ID. ### get_track_reviews Allows browsing and filtering of community reviews written for a specific track. ### search_tracks Performs a detailed search across the entire track catalog using keywords, tags, or speed settings. ### get_user_albums Retrieves the albums that your user account has interacted with previously. ### get_user_artists Retrieves a list of artists your user account has listened to or engaged with. ### get_user_tracks Retrieves tracks that are associated with your user account's history. ### get_users Looks up basic profile information for any given Jamendo user ID. ## Prompt Examples **Prompt:** ``` Search for high-speed instrumental tracks with the tag 'rock'. ``` **Response:** ``` I've searched the Jamendo catalog for high-speed instrumental rock. I found several tracks, including 'Electric Storm' and 'Fast Lane'. Would you like the streaming links for these? ``` **Prompt:** ``` Find artists located in Paris, France. ``` **Response:** ``` I've queried the artist locations. In Paris, France, I found artists like 'L'Atelier' and 'The Parisian Jazz Project'. Would you like to see their top albums? ``` **Prompt:** ``` Get tracks similar to track ID 12345. ``` **Response:** ``` Analyzing track 12345... I've found 5 similar tracks that match its style and tempo, including 'Midnight Sun' and 'Ocean Breeze'. Shall I list their details? ``` ## Capabilities ### Search by criteria Find specific tracks, albums, artists, and tags using prefix searches. ### Discover similar audio Get recommendations for tracks that match the style or tempo of a given ID. ### Filter by location Search for artists based on their country or city of origin. ### Browse metadata and reviews Retrieve detailed information, including community ratings, for specific albums or tracks. ### Manage user favorites Like a track, mark it as a favorite, or add it to a custom playlist using OAuth access. ## Use Cases ### The video editor needs BGM for a 'Paris' theme. Instead of searching Google for music, the agent uses `search_artists` to find artists in Paris. Then, it calls `get_artist_albums` and finally uses `get_album_tracks` to get track names suitable for a Parisian mood. The editor gets a curated list of assets in minutes. ### The developer is building a 'Top 10' playlist feature. The agent first calls `search_playlists` to find popular existing collections. Then, it uses `get_playlist_tracks` on the top result and filters that list using `get_similar_tracks` to ensure variety while maintaining a consistent vibe. ### The marketer needs local content for an ad campaign. They ask the agent to find artists in 'Austin, Texas'. The MCP uses `get_artist_locations` to filter the roster. The resulting artist list can then be checked with `get_user_artists` to ensure they are relevant to the brand. ### The user wants to curate a personal discovery feed. The agent checks which tracks you've recently listened to using `get_user_tracks`. It then uses that data, combined with `set_user_favorite`, to build a personalized recommendation list for the next week. ## Benefits - Need background music fast? You can use `search_tracks` to filter by specific criteria like speed (high/medium/low) or mood tags. This is better than just searching keywords because it narrows the results down immediately. - Never get stuck on a blank screen again. If you find one great track, call `get_similar_tracks`. It finds perfect alternatives that match the style and tempo of the original, making your selection process quick. - You can map out your content's needs by using `get_artist_locations` to discover independent talent from a specific country or city. This helps you find hyper-local artists for regional campaigns. - Build complex playlists without clicking anything. Use `search_playlists` and then `get_playlist_tracks` to populate custom lists, all initiated via chat commands. - It’s great for data work. You can pull detailed metadata—like album tracks using `get_album_tracks` or artist albums using `get_artist_albums`—and feed that directly into your coding environment. ## How It Works The bottom line is, you stop writing search queries; you just talk to your AI client. 1. Subscribe to this MCP and provide your Jamendo Client ID. 2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius catalog. 3. Ask your agent a natural language question, like 'Find me three upbeat indie tracks from France.' The agent uses the appropriate tool in the background and returns the results. ## Frequently Asked Questions **How does the Jamendo MCP help me find artists in specific countries?** Use `get_artist_locations`. This tool specifically filters and retrieves artist data based on their geographical location, letting you target regional talent for your projects. **Can I use the Jamendo MCP to get recommendations if I only know one track ID?** Yes. Call `get_similar_tracks` with that single ID. The agent analyzes its style and tempo against thousands of tracks, giving you a list of perfect alternatives. **What should I use if I need to find music by mood tags?** The `search_tracks` tool is best for this. It lets you search the entire catalog and filter results using detailed tags, alongside criteria like speed or vocal presence. **How do I add tracks to a playlist using Jamendo MCP?** You use `set_user_playlist`. This tool allows your agent to either create a new playlist or update an existing one, adding the chosen tracks in bulk via conversation. **What credentials do I need when calling tools like `set_user_like` via Jamendo MCP?** You must provide an OAuth2 access token. This handles user permissions, letting your agent perform actions like liking tracks or becoming a fan of artists on the user's behalf. **Can Jamendo MCP help me search for an album or artist without knowing any tracks?** Yes, you can use `search_albums` or `search_artists`. These tools filter results by name, genre, and location criteria so your agent finds exactly what you're looking for. **Does Jamendo MCP allow me to retrieve the track history of a user using `get_user_tracks`?** Yes, this function retrieves all tracks associated with a given user. Your agent can then analyze that list to summarize favorite genres or popular artists. **When using the `search_tracks` tool in Jamendo MCP, how do I handle massive results or pagination?** The API uses standard pagination. Always instruct your agent to process results in batches rather than requesting everything at once. This keeps calls reliable and prevents timeouts. **Can I search for music based on specific moods or technical attributes like speed?** Yes! Use the `search_tracks` tool with parameters like `tags` for mood and `speed` (high, medium, low) to filter the catalog exactly how you need. **How do I find artists from a specific city or country?** You can use the `get_artist_locations` tool. Simply provide the `location_country` (code) or `location_city` to see a list of artists from that area. **Is it possible to get recommendations based on a track I like?** Absolutely. Use the `get_similar_tracks` tool with the ID of the track you like, and the agent will return a list of musically similar tracks from the Jamendo library.