TIDAL MCP: My Custom Picks

Instructions

Deletes a TIDAL playlist by its ID.

USE THIS TOOL WHENEVER A USER ASKS FOR:
- "Delete my playlist"
- "Remove a playlist from my TIDAL account"
- "Get rid of this playlist"
- "Delete the playlist with ID X"
- Any request to delete or remove a TIDAL playlist

This function deletes a specific playlist from the user's TIDAL account.
The user must be authenticated with TIDAL first.

When processing the results of this tool:
1. Confirm the playlist was deleted successfully
2. Provide a clear message about the deletion

Args:
    playlist_id: The TIDAL ID of the playlist to delete (required)
    
Returns:
    A dictionary containing the status of the playlist deletion

Implementation Reference

• mcp_server/server.py:538-607 (handler)

  The main handler function for the 'delete_tidal_playlist' MCP tool. Decorated with @mcp.tool() for registration. Implements authentication check, input validation, and delegates the deletion to the Flask backend API via HTTP DELETE request to /api/playlists/{playlist_id}.

  @mcp.tool()
  def delete_tidal_playlist(playlist_id: str) -> dict:
      """
      Deletes a TIDAL playlist by its ID.
      
      USE THIS TOOL WHENEVER A USER ASKS FOR:
      - "Delete my playlist"
      - "Remove a playlist from my TIDAL account"
      - "Get rid of this playlist"
      - "Delete the playlist with ID X"
      - Any request to delete or remove a TIDAL playlist
      
      This function deletes a specific playlist from the user's TIDAL account.
      The user must be authenticated with TIDAL first.
      
      When processing the results of this tool:
      1. Confirm the playlist was deleted successfully
      2. Provide a clear message about the deletion
      
      Args:
          playlist_id: The TIDAL ID of the playlist to delete (required)
          
      Returns:
          A dictionary containing the status of the playlist deletion
      """
      # First, check if the user is authenticated
      auth_check = requests.get(f"{FLASK_APP_URL}/api/auth/status")
      auth_data = auth_check.json()
      
      if not auth_data.get("authenticated", False):
          return {
              "status": "error",
              "message": "You need to login to TIDAL first before deleting a playlist. Please use the tidal_login() function."
          }
      
      # Validate playlist_id
      if not playlist_id:
          return {
              "status": "error", 
              "message": "A playlist ID is required. You can get playlist IDs by using the get_user_playlists() function."
          }
      
      try:
          # Call the Flask endpoint to delete the playlist
          response = requests.delete(f"{FLASK_APP_URL}/api/playlists/{playlist_id}")
          
          # Check if the request was successful
          if response.status_code == 200:
              return response.json()
          elif response.status_code == 404:
              return {
                  "status": "error",
                  "message": f"Playlist with ID {playlist_id} not found. Please check the playlist ID and try again."
              }
          elif response.status_code == 401:
              return {
                  "status": "error",
                  "message": "Not authenticated with TIDAL. Please login first using tidal_login()."
              }
          else:
              error_data = response.json()
              return {
                  "status": "error",
                  "message": f"Failed to delete playlist: {error_data.get('error', 'Unknown error')}"
              }
      except Exception as e:
          return {
              "status": "error",
              "message": f"Failed to connect to TIDAL playlist service: {str(e)}"
          }