add_track_to_favorites
Save a track to your TIDAL favorites list. Use this tool to mark songs you enjoy for easy access and personalized recommendations.
Instructions
Add a track to user's favorites (like a track).
Args: track_id: ID of the track to add to favorites
Returns: Success status and confirmation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Operation status (success/error) | |
| item_id | Yes | ID of the item added to favorites | |
| message | Yes | Status message | |
| item_type | Yes | Type of item (track/album/artist) |
Implementation Reference
- src/tidal_mcp/server.py:436-466 (handler)Handler function decorated with @mcp.tool() which registers and implements the tool. Calls TIDAL API to add track to user favorites.
@mcp.tool() async def add_track_to_favorites(track_id: str) -> AddToFavoritesResult: """ Add a track to user's favorites (like a track). Args: track_id: ID of the track to add to favorites Returns: Success status and confirmation """ if not await ensure_authenticated(): raise ToolError("Not authenticated. Please run the 'login' tool first.") try: track_id_int = int(track_id) await anyio.to_thread.run_sync( session.user.favorites.add_track, track_id_int ) return AddToFavoritesResult( status="success", item_id=track_id, item_type="track", message=f"Track {track_id} added to favorites", ) except ValueError: raise ToolError(f"Invalid track ID format: {track_id}") except Exception as e: raise ToolError(f"Failed to add track to favorites: {str(e)}") - src/tidal_mcp/models.py:176-183 (schema)Pydantic model for the tool's output schema, defining the structure of the success response.
class AddToFavoritesResult(BaseModel): """Result of adding an item to favorites.""" status: str = Field(description="Operation status (success/error)") item_id: str = Field(description="ID of the item added to favorites") item_type: str = Field(description="Type of item (track/album/artist)") message: str = Field(description="Status message") - src/tidal_mcp/server.py:71-72 (registration)Tool mentioned in server instructions, part of the MCP server description for tool discovery.
- add_track_to_favorites: Like a track - remove_track_from_favorites: Unlike a track