# TIDAL Developer API MCP > The TIDAL Developer API lets your AI agent access high-fidelity music metadata directly. Use it to audit artist discographies, search for specific albums by title or artist, and retrieve detailed track lists, durations, and identifiers without logging into a separate streaming app. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** music-metadata, discography, audio-streaming, artist-catalog, track-lists, high-fidelity ## Description Your AI client uses the **TIDAL Developer API** to pull structured music data right from TIDAL's catalog. You don't gotta log into a separate streaming app; your agent handles all the heavy lifting, letting you audit discographies and get precise metadata points. It’s built for deep research—the kind of stuff an industry analyst needs when they can't just click around in an interface. When you need to know if the service is even up, start with `check_api_status`. That single call confirms whether the entire TIDAL Developer service is running smoothly. If that tool doesn't pass, none of the other calls matter, so it’s always smart to check first. Need to find an album? You can use `search_tidal_albums` to hunt for records by either the album name or the artist's name. This search returns basic metadata like how many tracks are on the record and what the total duration is, helping you narrow down your target quickly before diving deeper into specific IDs. If you start with an artist's name instead of an album title, `search_tidal_artists` locates that artist within the TIDAL catalog. This gives you the essential artist ID needed for everything else. Once you have that ID, you can immediately call `get_artist_albums`. That tool doesn't just give you a few albums; it retrieves every single album associated with that specific artist ID, letting you map out their entire recorded discography. If you know the exact name of an album but don't have its ID yet, you can use `search_tidal_albums` again. This finds the album and gives you the necessary metadata to proceed. If you already have that unique album ID, calling `get_album_tracks` fetches every single track belonging to it. You get a complete list of tracks, each with detailed associated metadata. These tools let your agent go beyond simple search results. They provide granular data points: the specific identifiers for any given piece of music, precise duration markers, and comprehensive lists that map out an artist’s full output. For instance, you can combine `search_tidal_artists` to find an ID, use that ID with `get_artist_albums` to get a list of five albums, then pick one album's ID and pass it into `get_album_tracks` to pull every single tracklist for analysis. You don't need any manual steps or guesswork; your agent runs the workflow based on what you prompt it with. ## Tools ### check_api_status Checks if the TIDAL Developer service is currently operational. ### get_album_tracks Gets all tracks belonging to a specific album using its ID. ### get_artist_albums Retrieves all albums associated with a given artist ID. ### search_tidal_albums Searches for albums on TIDAL using either the album name or the artist name. ### search_tidal_artists Searches and locates artists within the TIDAL catalog. ## Prompt Examples **Prompt:** ``` Search for album 'Lemonade' by Beyoncé using TIDAL. ``` **Response:** ``` I've retrieved the details for Lemonade! It was released in 2016 and features 12 tracks. Would you like the full tracklist or the artist's full discography metadata? ``` **Prompt:** ``` What are the tracks in the album with ID '12345'? ``` **Response:** ``` I've identified the tracks for that album! It includes 10 entries with their respective durations and unique identifiers. I can provide the direct links to each track if you'd like. ``` **Prompt:** ``` Search for artist 'Daft Punk' on TIDAL. ``` **Response:** ``` I've identified the artist Daft Punk! They are currently identified as an active entity in the TIDAL catalog. I can retrieve their full list of albums and top tracks to help you audit their discography. ``` ## Capabilities ### Check Service Status Verifies if the entire TIDAL Developer service is currently running. ### Search for Albums Find albums by name or artist, retrieving basic metadata like track count and duration. ### Search for Artists Locates artists within the TIDAL catalog using their known names. ### Get Artist's Full Discography Retrieves a list of all albums associated with a specific artist ID. ### Get Specific Album Tracklist Fetches every track, along with its metadata, for an album identified by its unique ID. ## Use Cases ### Verifying Album Details for a Feature A music journalist needs to confirm the track count and release date of an album. They ask their agent, which first uses `search_tidal_albums` (by name) and then confirms the details using the core metadata tools. The problem is solved instantly with structured data. ### Mapping an Artist's Career Timeline A curator wants to see every album released by Daft Punk. They instruct their agent to use `search_tidal_artists` first, then feed the resulting ID into `get_artist_albums`. This instantly provides a complete view of their discography for planning. ### Debugging Tracklist Issues A developer needs to know every track in an album with a specific ID. Instead of digging through the web, they prompt the agent, which executes `get_album_tracks`. They get 10 entries, each with its duration and unique identifier—no guesswork. ### Cross-Checking Metadata Reliability Before running a major analysis, an ops lead asks for system health. The agent runs `check_api_status` first. If the status is green, they know their entire cross-functional creative team workflow can proceed. ## Benefits - **Deep Metadata Access:** Forget guessing. You get high-resolution identifiers and exact duration markers for any track via `get_album_tracks` or the main API calls. This is essential for classification tasks. - **Rapid Discovery:** Need to find a specific album? Use `search_tidal_albums`. It lets your agent locate albums based on name or artist, saving you manual browsing time in music apps. - **Full Discography View:** Don't just look at one project. The `get_artist_albums` tool gives you the complete list of every album an artist has released by ID. - **Process Control:** Always confirm the API is up first. Use `check_api_status` to ensure your entire music research workflow starts and ends reliably. - **Structured Data Flow:** The agent processes results from multiple tools—say, finding an artist (`search_tidal_artists`) then getting their albums (`get_artist_albums`)—and presents it all in a clean format. ## How It Works The bottom line is: your agent handles complex music searches by calling specific functions on the TIDAL backend, so you don't have to. 1. Subscribe to the TIDAL Developer API server and input your key. 2. Your AI client runs a natural language query (e.g., 'Find all tracks for album XYZ'). 3. The agent executes the necessary tool call, pulls the structured metadata, and gives you a direct answer. ## Frequently Asked Questions **How do I find an artist's full list of albums using search_tidal_artists?** You first use `search_tidal_artists` to get the correct Artist ID. Then, take that ID and pass it into the `get_artist_albums` tool. This gets you every album title they have recorded. **Should I use search_tidal_albums or get_album_tracks?** Use `search_tidal_albums` if you only know the name and need to find the ID first. Use `get_album_tracks` when you already have a specific Album ID and want the full list of songs. **What is the best way to check service reliability with TIDAL Developer API?** Run the `check_api_status` tool. This instantly tells your agent if the entire music research workflow can proceed or if there's an issue with the connection. **Can I search for albums by artist name using TIDAL Developer API?** Yes, use `search_tidal_albums`. This tool allows you to input either the album title or the artist name into a single query and find matching records. **What is required before I can use `search_tidal_albums`?** You must provide a valid TIDAL Developer API key in your agent's configuration. Once connected, your AI client uses that key to make authenticated requests, allowing it to search for albums and retrieve metadata. **If I only have an album name, how do I get the track list using `get_album_tracks`?** You cannot use `get_album_tracks` directly with a name. First, you must run `search_tidal_albums` to find the correct Album ID. Then, pass that unique ID into the `get_album_tracks` tool. **How do I handle rate limits when using `get_artist_albums`?** If you hit a usage limit, the API will return an error code indicating rate throttling. Your agent needs to implement exponential backoff—meaning it should wait progressively longer periods before retrying the call. **Can `get_album_tracks` provide only track durations and identifiers?** The tool returns a full data object for every track. You can process this returned structure to filter out any fields you don't need, giving your agent just the duration markers and unique IDs. **How do I find my TIDAL API Key?** Register at the [**TIDAL Developer portal**](https://developer.tidal.com/), create an application, and you will receive your API Key. Copy and paste it below. **Can the agent show track durations?** Yes. Every track record retrieved by your agent includes metadata on the duration in seconds, which is automatically converted to minutes and seconds. **Does it support high-resolution audio info?** Yes. The TIDAL API provides metadata indicating available audio qualities (e.g., Lossless, High) for albums and tracks.