TIDAL MCP: My Custom Picks

Instructions

Authenticate with TIDAL through browser login flow.
This will open a browser window for the user to log in to their TIDAL account.

Returns:
    A dictionary containing authentication status and user information if successful

Implementation Reference

• mcp_server/server.py:22-49 (handler)

  The tidal_login tool handler function, registered via @mcp.tool() decorator. It handles authentication by calling the backend Flask API at /api/auth/login and returns success or error status with user info.

  @mcp.tool()
  def tidal_login() -> dict:
      """
      Authenticate with TIDAL through browser login flow.
      This will open a browser window for the user to log in to their TIDAL account.
      
      Returns:
          A dictionary containing authentication status and user information if successful
      """
      try:
          # Call your Flask endpoint for TIDAL authentication
          response = requests.get(f"{FLASK_APP_URL}/api/auth/login")
          
          # Check if the request was successful
          if response.status_code == 200:
              return response.json()
          else:
              error_data = response.json()
              return {
                  "status": "error",
                  "message": f"Authentication failed: {error_data.get('message', 'Unknown error')}"
              }
      except Exception as e:
          return {
              "status": "error",
              "message": f"Failed to connect to TIDAL authentication service: {str(e)}"
          }

• mcp_server/server.py:22-22 (registration)

  The @mcp.tool() decorator registers the tidal_login function as an MCP tool.

  @mcp.tool()

• mcp_server/server.py:23-30 (schema)

  Function signature and docstring defining the tool's schema: no input parameters, returns a dict with authentication status and optional user information.

  def tidal_login() -> dict:
      """
      Authenticate with TIDAL through browser login flow.
      This will open a browser window for the user to log in to their TIDAL account.
      
      Returns:
          A dictionary containing authentication status and user information if successful
      """