# AudD Music Recognition MCP MCP

> AudD Music Recognition connects your AI agent to a professional audio fingerprinting platform. It identifies songs by analyzing URLs, searching lyrics fragments, and pulling detailed track metadata (artist, album, release date). You can monitor live audio streams for background music or search large files starting at specific timecodes. It also finds direct streaming links for identified tracks on Spotify and Apple Music.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Tags:** music-recognition, lyrics-search, audio-fingerprinting, metadata-extraction, streaming-links

## Description

Think about this: you find a clip online, but the song playing underneath is never credited. Or maybe you remember only a few lines of lyrics from an old commercial—where did it come from? This MCP solves that. It lets your agent act like a dedicated musicologist. You feed it audio links or even just text fragments, and it does the heavy lifting. It goes past simple Shazam-style identification; it pulls comprehensive data, including album details and direct streaming URLs for major platforms. Whether you're editing a video or doing deep research, this tool gives your agent the ability to analyze sound sources and retrieve precise information about music tracks using only natural conversation. Because Vinkius hosts thousands of MCPs, integrating AudD means giving your AI client an entire professional library of audio data analysis tools right out of the box.

## Tools

### add_monitored_stream
Sets up an audio source that the agent will continuously monitor for music identification.

### get_lyrics
Pulls the complete, matched lyrics when given a specific song identifier or track name.

### list_monitored_streams
Shows all audio streams that are currently set up for monitoring by the agent.

### recognize_at_time
Starts music identification on a long file, but only beginning at a specific second offset in the track.

### recognize_music
Identifies a song by processing an audio URL and returns the artist, title, album, and streaming links.

### search_lyrics
Finds songs and associated metadata when you provide just a short text fragment of lyrics.

### search_music
Performs a general search for song titles or artists using plain text queries.

### set_stream_callback_url
Defines the webhook URL where results should be sent after continuous stream monitoring is complete.

## Prompt Examples

**Prompt:** 
```
Identify the song at this URL: https://example.com/audio.mp3
```

**Response:** 
```
I've identified the track as 'Blinding Lights' by The Weeknd from the album 'After Hours'. I have the streaming links for Spotify and Apple Music ready for you. Would you like to see the lyrics?
```

**Prompt:** 
```
Search for lyrics containing 'never gonna give you up'.
```

**Response:** 
```
I found the lyrics for 'Never Gonna Give You Up' by Rick Astley. It's a classic! I can show you the full text or find where you can listen to it.
```

**Prompt:** 
```
Find the artist and album for the song 'Stairway to Heaven'.
```

**Response:** 
```
Searching... 'Stairway to Heaven' is by Led Zeppelin, from their untitled fourth album (often called Led Zeppelin IV), released in 1971. It is considered one of the greatest rock songs of all time.
```

## Capabilities

### Identify songs from URLs
Pass any publicly accessible audio link to figure out what song it is.

### Monitor live or long streams
Watch an ongoing audio feed or pinpoint a specific time in a long file to identify the music playing.

### Search by lyrical fragments
Input a few lines of lyrics and find the song and full text associated with them.

### Get detailed track information
Retrieve metadata like the artist, album title, release date, and record label for any identified track.

### Find streaming links
Generate direct URLs so you can listen to the identified song on Spotify or Apple Music.

## Use Cases

### Podcast Editing
A producer finds a great background track from a YouTube video but needs the official album details for credits. The agent uses `recognize_music` on the URL, quickly pulling the artist and release date to complete the show notes.

### Forensic Audio Analysis
An audio engineer is reviewing a long recording and needs to know what song played exactly 3:12 into the file. They use `recognize_at_time` to pinpoint the moment, getting immediate identification without manual scrubbing.

### Academic Thesis Writing
A music researcher only has a snippet of lyrics from an old song and needs its full context. The agent uses `search_lyrics`, pulling the complete text and associated metadata for inclusion in their paper.

## Benefits

- Stop manually cross-referencing song details. Use the `recognize_music` tool to analyze an audio URL in one step, getting the artist name, album info, and multiple streaming links immediately.
- Don't struggle with background music in videos. Set up continuous monitoring using `add_monitored_stream` so your agent alerts you when a specific track is detected.
- If you only remember a few lines of lyrics, use `search_lyrics`. It finds the full text and metadata without needing the original audio file—a huge time saver for researchers.
- Need to analyze an hour-long podcast but only care about the segment at minute 45? Use `recognize_at_time` to pinpoint music recognition starting exactly at a specific offset.
- When you need to integrate this into your own code, the MCP provides specialized tools like `set_stream_callback_url`, letting results flow automatically to another system or script.

## How It Works

The bottom line is that your AI client handles all the complexity of audio fingerprinting and data retrieval behind one simple chat interface.

1. Subscribe to this MCP and provide your unique AudD API Token.
2. Connect your AI client, then prompt it with an audio URL or lyric snippet. You don't need to know the underlying tools; just ask the question.
3. Your agent uses its built-in logic to call the necessary functions, returning structured data like artist name, album info, and multiple streaming links.

## Frequently Asked Questions

**How do I use `recognize_music` to find out what song is playing in an MP3 file?**
You simply pass the direct URL of the MP3 file into your agent. The `recognize_music` tool handles the fingerprinting and returns the artist, title, album data, and streaming links.

**If I only have lyrics, how do I find the song? Do I need to use `search_lyrics`?**
Yes, that's exactly what `search_lyrics` is for. You just input a few lines of text, and it searches its database to match you with the correct track metadata.

**Can I use `recognize_at_time` if the audio file is very long?**
Absolutely. This tool lets you specify an exact time offset (like 1:32) in a long audio file, so your agent only analyzes the music starting from that moment.

**How does `add_monitored_stream` work for live radio?**
You use `add_monitored_stream` to set up a continuous feed. The MCP then monitors that stream and reports the song details when it detects a change in music.

**When I use `set_stream_callback_url`, how does my agent receive music recognition results in real time?**
The webhook URL you provide receives the music data instantly. Your agent processes streaming events directly, eliminating the need for constant polling and making live monitoring efficient.

**If I only have a vague phrase, how do I use `search_music` to find potential song metadata?**
It searches the database using text queries, returning title, artist, and album details. This works when you don't have a direct URL or enough lyrics for a precise match.

**How do I check which audio streams are currently active using `list_monitored_streams`?**
It returns a list of all URLs and associated metadata you've set up for monitoring. This lets you verify your current monitoring scope before running new recognition jobs.

**If I run `recognize_music` on an audio file with background noise, what kind of result do I get?**
The tool still attempts to pull core metadata despite noise. Results will provide the best match and often include a confidence score alongside the identified track details.

**Can I identify a song just by providing a link to an MP3 file?**
Yes! Use the `recognize_music` tool and provide the direct URL to the audio file. Your agent will identify the track and provide metadata and streaming links.

**How do I find the lyrics for a song if I only know a few words?**
You can use the `search_lyrics` tool with those words. Your agent will search AudD's database for matching lyrics and return the full text and song details.

**Can I get direct links to open the song on Spotify or Apple Music?**
Yes, when identifying a song or searching for one, you can request extra data that includes direct streaming links for various platforms.