get_favorite_artists
Retrieve a user's followed artists from TIDAL music service to access their favorite musicians and build personalized music experiences.
Instructions
Get user's favorite (followed) artists from TIDAL.
Args: limit: Maximum artists to retrieve (default: 50)
Returns: List of followed artists
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Number of artists returned | |
| query | No | Search query used (for search results) | |
| status | Yes | Operation status (success/error) | |
| artists | Yes | List of artist objects |
Implementation Reference
- src/tidal_mcp/server.py:1189-1221 (handler)The main handler function for the 'get_favorite_artists' tool. It fetches the user's followed artists from TIDAL using the tidalapi library, authenticates if needed, and returns a structured ArtistList.
@mcp.tool() async def get_favorite_artists(limit: int = 50) -> ArtistList: """ Get user's favorite (followed) artists from TIDAL. Args: limit: Maximum artists to retrieve (default: 50) Returns: List of followed artists """ if not await ensure_authenticated(): raise ToolError("Not authenticated. Please run the 'login' tool first.") try: favorites = await anyio.to_thread.run_sync( lambda: session.user.favorites.artists(limit=limit) ) artists = [] for artist in favorites: artists.append( Artist( id=str(artist.id), name=artist.name, url=f"https://tidal.com/browse/artist/{artist.id}", ) ) return ArtistList(status="success", count=len(artists), artists=artists) except Exception as e: raise ToolError(f"Failed to get favorite artists: {str(e)}") - src/tidal_mcp/models.py:80-87 (schema)Pydantic model defining the structured output schema returned by the get_favorite_artists tool, including status, count, and list of Artist objects.
class ArtistList(BaseModel): """List of artists with metadata.""" status: str = Field(description="Operation status (success/error)") query: Optional[str] = Field(None, description="Search query used (for search results)") count: int = Field(description="Number of artists returned") artists: List[Artist] = Field(description="List of artist objects") - src/tidal_mcp/models.py:39-45 (schema)Base Pydantic model for individual Artist objects used within ArtistList.
class Artist(BaseModel): """Structured representation of a TIDAL artist.""" id: str = Field(description="Unique TIDAL artist ID") name: str = Field(description="Artist name") url: str = Field(description="TIDAL web URL for the artist") - src/tidal_mcp/server.py:70-70 (registration)Tool description in the server instructions docstring, which serves as informal registration documentation listing all available tools.
- get_favorite_artists: Get your followed artists