TIDAL MCP Server

Instructions

Implementation Reference

• src/tidal_mcp/server.py:777-823 (handler)

  The main async handler function for the 'get_album_tracks' tool. It authenticates if needed, fetches the album using tidalapi.session.album(album_id), retrieves its tracks, maps them to Track models, and returns an AlbumTracks response.
  @mcp.tool() async def get_album_tracks(album_id: str) -> AlbumTracks: """ Get all tracks from a specific album. Args: album_id: ID of the album Returns: List of tracks in the album with album metadata """ if not await ensure_authenticated(): raise ToolError("Not authenticated. Please run the 'login' tool first.") try: album = await anyio.to_thread.run_sync(session.album, album_id) if not album: raise ToolError(f"Album with ID '{album_id}' not found") album_tracks = await anyio.to_thread.run_sync(album.tracks) tracks = [] for track in album_tracks: tracks.append( Track( id=str(track.id), title=track.name, artist=track.artist.name if track.artist else "Unknown Artist", album=album.name, duration_seconds=track.duration, url=f"https://tidal.com/browse/track/{track.id}", ) ) return AlbumTracks( status="success", album_title=album.name, album_id=album_id, artist=album.artist.name if album.artist else "Unknown Artist", count=len(tracks), tracks=tracks, ) except ToolError: raise except Exception as e: raise ToolError(f"Failed to get album tracks: {str(e)}")
• src/tidal_mcp/models.py:108-117 (schema)

  Pydantic BaseModel defining the structured output schema for the get_album_tracks tool response, including album metadata and list of Track objects.
  class AlbumTracks(BaseModel): """Tracks from a specific album.""" status: str = Field(description="Operation status (success/error)") album_title: str = Field(description="Title of the album") album_id: str = Field(description="ID of the album") artist: str = Field(description="Album artist name") count: int = Field(description="Number of tracks returned") tracks: List[Track] = Field(description="List of track objects")
• src/tidal_mcp/server.py:85-85 (registration)

  The tool is listed in the SERVER_INSTRUCTIONS string, which provides documentation and context for the MCP server's capabilities, including this tool.
  - get_album_tracks: Get all tracks from an album