# Discogs MCP MCP > Discogs connects your AI client to the world’s deepest music metadata database. Search everything—artists, labels, releases, and marketplace listings—to map out complete discographies and track specific pressings. Use it for academic research, inventory pricing, or just finding that one rare vinyl edition. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** music-database, discography, marketplace, collecting, metadata ## Description You're dealing with complex creative works, not simple data points. Discogs lets your agent treat the entire history of recorded music like a structured database. Instead of bouncing between label websites and forum deep dives to verify details, you get instant access to metadata for artists, tracks, and record labels globally. You can trace a release back through its master version to see every single pressing—UK vinyl, Japanese CD, cassette reissue—and compare all the technical specs instantly. When dealing with market values or provenance, data integrity is everything; that's why the whole process runs inside Vinkius, which guarantees that every tool call produces a cryptographically signed audit trail. This means you know exactly what data flowed and when. You can research an artist’s full career arc, compare multiple pressings of one album, or check current market prices for rare items—all through natural conversation. ## Tools ### database_search Search the entire catalog using free text across artists, releases, labels, or genres. ### get_artist Retrieve detailed profile information, including biography and member lists, for a specific artist. ### get_artist_releases List every album, single, or compilation released by an artist over time. ### get_label Get the corporate structure and profile details for a specific record label. ### get_label_releases List all releases published by a given label, useful for catalog research. ### get_marketplace_listings View current sales listings, including price and condition, for any specific release. ### get_master_release Identify the core, canonical version of an album to view its overall creative work details. ### get_master_release_versions List all physical pressings and variations (e.g., vinyl vs. cassette) associated with a master release. ### get_release Get the absolute most detailed metadata for one specific, finished product or edition. ### get_release_stats Calculate market statistics like median sale price and current listing count for a release. ### get_user_collection See the contents of any public user collection or wantlist, including basic metadata. ### get_user_profile Fetch a public user’s profile details, like their location and contribution history. ### get_user_wantlist See what specific releases other collectors are currently trying to find or buy. ## Prompt Examples **Prompt:** ``` Search for Pink Floyd's 'The Dark Side of the Moon' and show me all vinyl pressings. ``` **Response:** ``` I found the master release for 'The Dark Side of the Moon' and retrieved all vinyl versions. There are 47 pressings worldwide, including the original 1973 UK Harvest pressing, 2016 remaster, and Japanese obi editions. Here are the details with marketplace prices. ``` **Prompt:** ``` Show me the complete discography of Daft Punk. ``` **Response:** ``` Here's Daft Punk's complete discography from 1992 to 2021. It includes 4 studio albums (Homework, Discovery, Human After All, Random Access Memories), 2 live albums, numerous singles and EPs, and compilation appearances. Here are all 89 releases sorted by year. ``` **Prompt:** ``` What's the market value of the original 1969 Beatles 'Abbey Road' vinyl in good condition? ``` **Response:** ``` Based on Discogs community data, the original 1969 UK Apple pressing of Abbey Road (PCS 7088) has a median sale price of $180. The lowest current listing is $125 in VG+ condition, and the highest recent sale was $350 for a near mint copy. Here are 12 active listings with prices and conditions. ``` ## Capabilities ### Map a complete discography Get every studio album, single, and compilation credited to an artist over their career. ### Trace specific pressings (variants) Identify the canonical version of an album and list every historical pressing or format it came out on. ### Research label history Explore a record label's full corporate structure, including its sublabels and complete catalog output. ### Analyze market demand Determine the median sale price, range of listing prices, and current supply for any specific release. ### Identify collector value View what other collectors are actively tracking in their wantlists or public collections. ## Use Cases ### Researching a Lost Album Variation You're tracking down an original 1973 pressing of *The Dark Side of the Moon*. Your agent first uses database_search to find the master release, then calls get_master_release_versions to list all possible pressings. Finally, it uses get_marketplace_listings to show you current prices for only vinyl variants. ### Determining an Album's True Value A client wants to know if their copy of a 1985 release is valuable. The agent runs get_release_stats, which provides the median and range of sale prices, giving you immediate data on market demand. ### Mapping an Artist's Trajectory You need to show a client how one artist shifted style over 30 years. The agent calls get_artist_releases to pull all outputs and then uses get_label to show which labels handled the different phases of their career. ### Building a Collection Overview You want to see what's missing from your collection. The agent checks get_user_wantlist for specific artists and then uses database_search to find those titles on the open marketplace, showing you immediate purchasing options. ## Benefits - Pinpoint exact market values: Instead of guessing a fair asking price, use get_release_stats to find the median sale price and lowest current listing for any item. - Compare pressings instantly: Use get_master_release_versions when you need to know if an album was released on vinyl, CD, or cassette in different years and countries. - Build a career timeline: Run get_artist_releases to pull every recorded output from one artist, keeping track of their evolution across decades. - Verify label scope: Use get_label to see the full corporate structure—which sublabels they own and what releases are credited to them. - Source rare items: Check get_user_wantlist to see which specific, hard-to-find records other collectors are actively hunting for right now. ## How It Works The bottom line is you get deep musical metadata analysis without ever leaving your AI chat interface. 1. Subscribe to the MCP and provide your Discogs User Token. 2. Connect your AI client (Claude, Cursor, etc.) to the Vinkius platform. 3. Ask your agent a question like, 'What were all vinyl pressings of The Wall?' to start gathering metadata. ## Frequently Asked Questions **How do I find all versions of a single album using get_master_release_versions?** You first use database_search to identify the core master release. Then, run get_master_release_versions and specify the title or ID; this lists every known pressing variant for you. **Do I need to know an artist’s name before using get_artist?** No. You can start by using database_search with general keywords, then use get_artist on the ID provided in those initial search results. **What is the difference between get_release and get_master_release?** get_master_release describes the overall creative work (the concept); get_release gives you all the specific, technical data points for one physical edition of that work. **Can I check market prices using get_marketplace_listings?** Yes. This tool pulls real-time seller information—price, condition, and currency—for a specified release, letting you compare deals instantly. **How do I use `database_search` to filter results by genre or style?** You pass the specific filters directly into the query parameters. This lets you narrow down massive result sets immediately, focusing your search on precise criteria like a year, country, or genre. **What information does `get_label` provide about a record company's history?** It returns the label's profile and its corporate structure. You can see its parent labels and all associated sublabels, helping you track catalog organization or historical changes in publishing. **Can I use `get_user_collection` to understand what genres collectors value?** It returns a list of releases with basic metadata. While deep details are restricted, viewing public collections shows you which artists and formats are highly popular among the community. **What key metrics does `get_release_stats` provide for market research?** It gives you three crucial pricing points: the lowest, median, and highest sale prices. You also get a count of active listings, which helps measure both rarity and current market demand.