# AcoustID MCP > AcoustID identifies songs using audio fingerprints—it's basically Shazam for developers. You feed it a clip, and it returns full metadata, like the artist, album, and MusicBrainz ID. Need to search recordings by name or find all associated fingerprints? This MCP handles it, giving you deep access to music library data without needing an API key for basic lookups. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Tags:** audio-fingerprinting, music-identification, metadata-lookup, music-recognition, audio-analysis ## Description This connector lets your agent identify songs just by listening to a short audio clip. You don't need to know the title or artist; you just submit a fingerprint and get immediate results. It pulls rich metadata, linking the song directly to its MusicBrainz ID and providing details about the release group. The system also allows you to search for recordings using general criteria, like an artist name, or look up all associated fingerprints if you already have a known MusicBrainz ID. If you're building anything audio-related, connecting this MCP through Vinkius means your AI client has immediate access to thousands of music records and metadata types. Plus, you can even submit new fingerprints if you find a song that needs adding to the database. ## Tools ### get_recording_metadata Gets full details for a recording—like artists and release groups—using an existing AcoustID. ### lookup_by_fingerprint Identifies a song by taking an audio fingerprint string and the clip's duration. ### search_by_mbid Finds all associated fingerprints for a specific MusicBrainz ID, useful if you know the recording but not the fingerprints. ### search_by_recording Locates matching recordings by providing general text like an artist or song name. ### submit_fingerprint Adds a new audio fingerprint to the system, requiring the chromaprint string and duration. ## Prompt Examples **Prompt:** ``` Search for 'Bohemian Rhapsody' by Queen. ``` **Response:** ``` Found Bohemian Rhapsody by Queen. AcoustID: 0e5e5b5e-... MusicBrainz ID: b1a9c0e9-... Multiple fingerprints available for this recording. ``` **Prompt:** ``` Search recordings by Daft Punk. ``` **Response:** ``` Found multiple Daft Punk recordings: Get Lucky (95% match), One More Time (92% match), Around the World (89% match), Harder Better Faster Stronger (88% match). Each with AcoustID and MusicBrainz ID. ``` **Prompt:** ``` Get metadata for AcoustID 0e5e5b5e-. ``` **Response:** ``` AcoustID 0e5e5b5e-: Bohemian Rhapsody — Queen. Linked to MusicBrainz ID: b1a9c0e9-... from album 'A Night at the Opera' (1975). Multiple fingerprints associated with this recording. ``` ## Capabilities ### Identify songs from audio clips Submit an audio fingerprint, and the MCP returns matching recordings with confidence scores, titles, and artists. ### Find metadata for a specific recording Retrieve all associated details—like the original artist, album name, and release groups—using a known AcoustID. ### Search recordings by text criteria Look up records using general search terms like an artist's name or a song title. ### Find fingerprints for a given ID Use a MusicBrainz ID to retrieve every associated audio fingerprint, which is useful for batch processing. ### Contribute new data Submit new audio fingerprints to expand the database with information about unknown songs. ## Use Cases ### Tracking down a background track An audio engineer captures 10 seconds of ambient music. Instead of uploading it to three different web services, they ask their agent to run the fingerprint through `lookup_by_fingerprint`. The result immediately provides the artist and album name for inclusion in the project credits. ### Validating a media asset batch A researcher acquires 50 audio files, all supposedly from the same forgotten band. Instead of manually searching each one, they use `search_by_mbid` on known identifiers to quickly verify if all fingerprints link back to the correct source material. ### Building a media catalog A developer is building an audio player feature and needs to know the metadata for every track. They use `search_by_recording` with known artist names, then feed those results into `get_recording_metadata` to build a complete, structured database. ### Expanding the song library A music enthusiast records an unindexed local recording. They use the system's capability to submit a fingerprint, allowing them to contribute the new data via `submit_fingerprint` and build out the resource for future users. ## Benefits - Instant identification: Use `lookup_by_fingerprint` to instantly match an unknown track by analyzing a short audio clip, giving you titles and artists right away. - Deep metadata access: Pull comprehensive details for any record via `get_recording_metadata`, including associated release groups and original recording metadata. - Cross-reference data: If you have a MusicBrainz ID, use `search_by_mbid` to find every related audio fingerprint—a huge time saver for researchers. - Broad searching capability: When you only know the artist or title, `search_by_recording` finds the necessary identifiers without requiring specific fingerprints. - Database contribution: Use `submit_fingerprint` to expand your knowledge base by adding newly captured songs directly into the AcoustID database. ## How It Works The bottom line is that you get actionable, standardized music data without having to manage complex authentication keys. 1. Start by connecting your AI client to this MCP on Vinkius. No API key is needed for basic lookups. 2. You provide the necessary data—whether it's an audio fingerprint, a MusicBrainz ID, or just a title and artist name. 3. The MCP processes the request against the AcoustID database and returns structured metadata about the matching recordings. ## Frequently Asked Questions **How do I identify a song using AcoustID MCP?** You run `lookup_by_fingerprint` by providing the chromaprint fingerprint string and the audio duration in seconds. The system returns matching records, titles, and artists. **What is the best way to search for a song using AcoustID MCP?** If you only know the name or artist, use `search_by_recording`. This tool handles general text inputs and finds relevant records across the database. **Can I get full metadata using AcoustID MCP?** Yes. Use `get_recording_metadata` with an existing AcoustID to retrieve comprehensive details, including artist names and release group information. **How do I add a song fingerprint using AcoustID MCP?** You use the `submit_fingerprint` tool. You must provide the chromaprint fingerprint string and audio duration; you can optionally include name and artist for better indexing. **Does search_by_mbid work if I don't know the fingerprints?** Yes, that is exactly what it does. If you have a MusicBrainz ID but no specific fingerprint, `search_by_mbid` retrieves all associated audio fingerprints for you. **If I know a MusicBrainz ID but not the fingerprints, how do I use `search_by_mbid`?** It finds all associated AcoustID fingerprints for that single MusicBrainz recording. This is useful because it lets you gather every available fingerprint linked to the known song record. **When I run `search_by_recording`, what specific IDs do I receive for a found track?** You get the matching recording's AcoustID, MusicBrainz ID, title, and artist name. This initial search gives you key identifiers needed to perform more detailed metadata lookups. **Does `lookup_by_fingerprint` require both the fingerprint string and audio duration?** Yes, it requires both parameters to run successfully. You must provide the Chromaprint fingerprint *and* the precise audio length in seconds for a match attempt. **Do I need an API key?** No! AcoustID's public API works without authentication using a default client key for basic lookups. **How does audio fingerprinting work?** AcoustID uses Chromaprint (fpcalc) to generate a fingerprint from audio. This fingerprint is matched against the database to identify the song. You need to run fpcalc on an audio file to get the fingerprint string. **What is MusicBrainz?** MusicBrainz is an open music encyclopedia that collects music metadata. AcoustID links audio fingerprints to MusicBrainz recordings, enabling song identification through the MusicBrainz ID (MBID).