mcp-apple-music

Instructions

Implementation Reference

• src/mcp_apple_music/server.py:466-491 (handler)

  The implementation of the get_recommendations tool handler.

  async def get_recommendations(limit: int = 5) -> str:
      """Get personalised Apple Music recommendations.
  
      Args:
          limit: Number of recommendation groups to return, 1–10 (default 5).
      """
      client = _get_client()
      data = await client.get(
          "/me/recommendations",
          params={"limit": min(max(1, limit), 10)},
      )
      recs = data.get("data", [])
  
      if not recs:
          return "No recommendations available right now."
  
      lines = ["🎯 Personalised Recommendations:\n"]
      for rec in recs:
          a = rec.get("attributes", {})
          title_obj = a.get("title", {})
          title = (
              title_obj.get("stringForDisplay", "")
              if isinstance(title_obj, dict)
              else str(title_obj)
          ) or "Recommendation"
          lines.append(f"\n📌 {title}")