# 7digital MCP > 7digital MCP connects your AI client directly to a global music catalog. Find artists by name across regions, get detailed discographies, search specific tracks, fetch track listings for any album, and even manage purchasing actions like adding items to a shopping basket or checking out. ## Overview - **Category:** audio-music - **Price:** Free - **Tags:** music-catalog, artist-data, discography, metadata, media-streaming ## Description This MCP lets your agent interact with the full 7digital music catalog using natural conversation. Instead of navigating multiple e-commerce sites and clicking through pages, you simply ask for data—whether it's finding an artist in a specific country or getting the tracklist for a back-catalogue album. It handles everything from broad searches to granular details like 30-second audio previews. Because this MCP is hosted on Vinkius, your agent gets access to standardized tools, letting you integrate complex buying flows and metadata retrieval into any client, like Cursor or Claude. You can manage the entire journey: search for an album using a title, fetch its complete track details, get a preview URL for one song, and finally add the whole release to a shopping basket. ## Tools ### get_track_preview Generates an audio URL for a 30-second preview of any individual song by its unique track ID. ### add_to_basket Adds a specified release ID to the active 7digital shopping basket and returns updated contents with pricing. ### get_artist_details Retrieves detailed profile information for an artist, requiring their unique artist ID. ### get_artist_releases Lists all albums, singles, and EPs associated with a given artist ID. ### get_basket Shows the current items in the shopping basket, including titles, quantities, and prices. ### get_checkout_url Generates the final URL needed to complete a purchase using the contents of the current basket. ### get_release_details Fetches comprehensive information for a specific album release, needing its ID. ### get_release_tracks Lists every track title, artist, and duration from a given album release ID. ### search_artist Finds artists by name and regional code, returning their profile summary and number of releases. ### search_release Searches for albums or full releases using a title or artist name across the catalog. ### search_track Searches for individual songs by title or artist, returning basic metadata and explicit content flags. ## Prompt Examples **Prompt:** ``` Search for Radiohead albums. ``` **Response:** ``` Found 12 Radiohead releases: OK Computer (1997), Kid A (2000), In Rainbows (2007), The Bends (1995), A Moon Shaped Pool (2016) and more. Each with track lists, genres and purchase links. ``` **Prompt:** ``` Get the track listing for OK Computer. ``` **Response:** ``` OK Computer (1997) — 12 tracks: 1. Airbag (4:44) 2. Paranoid Android (6:23) 3. Subterranean Homesick Alien (4:27) 4. Exit Music (For a Film) (4:24) 5. Let Down (4:59) 6. Karma Police (4:21) 7. No Surprises (3:48) 8. Lucky (4:19) 9. The Tourist (5:24) and more. ``` **Prompt:** ``` Play a preview of Paranoid Android. ``` **Response:** ``` Preview URL: https://preview.7digital.com/clip/xxxxx.mp3 (30s preview, audio/mpeg). Duration: 6:23. ``` ## Capabilities ### Search Artists Find artists by name globally, checking their profile and total number of releases. ### Get Artist Discography View all albums, singles, and EPs released by a specific artist. ### Search Releases & Tracks Locate specific albums or individual tracks using titles or artist names. ### Retrieve Detailed Metadata Fetch full information on any release, including genre, label, and original track list. ### Get Audio Previews Generate streaming URLs for 30-second previews of specific tracks. ### Manage Purchase Flow Add items to a basket, check the contents and prices, or generate the final checkout URL. ## Use Cases ### Verifying an Artist's Back Catalog A content curator needs to know every album by Fleetwood Mac, regardless of when it came out. They run `search_artist` first, then use `get_artist_releases`. This returns a complete list of albums and singles, allowing them to accurately map the artist's entire history for an encyclopedia entry. ### Building a Digital Media Storefront A developer is building a new music store. They use `search_release` to find potential titles, then call `get_release_details` to pull metadata (genre, label). Finally, they use `add_to_basket` to let the user buy it. ### Checking a Song's Pre-Purchase Details A journalist wants to write about a song but needs to confirm if it was on an album. They run `search_track`, get the results, and then use `get_release_tracks` with the related release ID to verify its track number and neighbors. ### Troubleshooting Checkout Failures A user reports that their shopping cart is empty. The agent first calls `get_basket`. If it's still empty, they can use a previous search result ID to call `add_to_basket` and then re-check the contents. ## Benefits - Verify full discographies: Use `get_artist_releases` to get every album, single, and EP an artist has put out, preventing missed content listings. - Check regional availability: The search tools accept country codes (like US or DE), letting you confirm if a specific release is available in the target market. - Build checkout flows: `add_to_basket` and `get_checkout_url` let your agent handle transactions, making it possible to complete purchases without leaving your application's UI. - Detail verification: Need proof of track contents? Calling `get_release_tracks` gives you the full list for an album, which is critical for content accuracy. - Quick previews: Use `get_track_preview` to grab a streaming URL. This lets users sample a song instantly without needing the full purchase process. ## How It Works The bottom line is you get real-time access to global music data and e-commerce functions through API calls your agent executes. 1. Subscribe to this MCP on Vinkius and input your 7digital API Key. 2. Connect your preferred AI agent (e.g., Cursor or Claude). 3. Ask the agent to perform a music catalog action, such as searching for an artist's albums or getting a track preview. ## Frequently Asked Questions **How do I find out if an artist exists in the 7digital catalog using search_artist?** You use `search_artist` and pass a name along with a country code (e.g., 'US'). The response gives you their profile summary, confirming existence and listing total releases for that region. **Does 7digital MCP let me check the tracklist for an album?** Yes. After you find a release ID using `search_release` or `get_artist_releases`, calling `get_release_tracks` returns every song title, duration, and track number. **How do I handle buying items with 7digital MCP?** You manage the transaction flow by first using `add_to_basket` to select items. Then call `get_checkout_url` when ready, and your agent provides the final purchase link. **Can I get an audio preview of a song with 7digital MCP?** Yes, you must use `get_track_preview`. You need to pass the specific track ID into this tool, and it returns the temporary streaming URL for the 30-second clip. **What is required before I can use get_basket to view my items?** You must have an active 7digital developer account and API key. The MCP validates your credentials upon connection, allowing you to retrieve the current contents of the shopping basket. **What specific information does get_artist_details return about a musician?** It returns detailed profile data for an artist, including their images, discography overview, and names of similar artists. This lets you build out rich profiles in your own applications. **If I only know the track name, how do I find it using search_track?** Use `search_track`. This tool searches for individual songs by title or artist. It returns crucial metadata like duration, release information, and explicit content flags. **How can I retrieve a complete list of every album an artist has released using get_artist_releases?** Use `get_artist_releases`. This tool provides titles, release types (EP, Single, Album), and dates for all works associated with the specified artist ID. **How do I get a 7digital API key?** Register at [**7digital.com/developer**](https://www.7digital.com/developer) and sign up for a free developer account. You'll receive an API consumer key. **Can I listen to full tracks?** The API provides 30-second preview streams for tracks. Full track purchases are available through the 7digital store integration. **What countries are supported?** 7digital operates in 30+ countries including US, GB, DE, FR, ES, IT, AU, CA, JP and many more. Use the country parameter for region-specific catalogs and pricing.