TIDAL MCP Server

Instructions

Implementation Reference

• src/tidal_mcp/server.py:740-771 (handler)

  The handler function that implements the delete_playlist tool. It checks authentication, retrieves the playlist object using session.playlist(playlist_id), deletes it with playlist.delete(), and returns a DeletePlaylistResult.

  @mcp.tool()
  async def delete_playlist(playlist_id: str) -> DeletePlaylistResult:
      """
      Delete a playlist from user's account.
  
      Args:
          playlist_id: ID of the playlist to delete
  
      Returns:
          Confirmation of deletion
      """
      if not await ensure_authenticated():
          raise ToolError("Not authenticated. Please run the 'login' tool first.")
  
      try:
          playlist = await anyio.to_thread.run_sync(session.playlist, playlist_id)
          if not playlist:
              raise ToolError(f"Playlist with ID '{playlist_id}' not found")
  
          playlist_name = playlist.name
          await anyio.to_thread.run_sync(playlist.delete)
  
          return DeletePlaylistResult(
              status="success",
              playlist_id=playlist_id,
              message=f"Deleted playlist '{playlist_name}'",
          )
      except ToolError:
          raise
      except Exception as e:
          raise ToolError(f"Failed to delete playlist: {str(e)}")

• src/tidal_mcp/models.py:168-174 (schema)

  Pydantic BaseModel defining the return schema for the delete_playlist tool, including status, playlist_id, and message fields.

  class DeletePlaylistResult(BaseModel):
      """Result of deleting a playlist."""
  
      status: str = Field(description="Operation status (success/error)")
      playlist_id: str = Field(description="ID of the deleted playlist")
      message: str = Field(description="Status message")

• src/tidal_mcp/server.py:82-82 (registration)

  The tool is listed in the server instructions/docstring, indicating it is available.

  - delete_playlist: Delete a playlist

• src/tidal_mcp/server.py:19-45 (schema)

  Import of the DeletePlaylistResult schema used by the delete_playlist handler.

  from .models import (
      # Core entities
      Track,
      Album,
      Artist,
      Playlist,
      # List responses
      TrackList,
      AlbumList,
      ArtistList,
      PlaylistList,
      PlaylistTracks,
      AlbumTracks,
      # Detail responses
      ArtistDetails,
      AlbumDetails,
      RadioTracks,
      # Operation results
      AuthResult,
      CreatePlaylistResult,
      AddTracksResult,
      RemoveTracksResult,
      UpdatePlaylistResult,
      DeletePlaylistResult,
      AddToFavoritesResult,
      RemoveFromFavoritesResult,
  )