get_recommendations
Generate personalized Apple Music recommendations based on your listening preferences. Specify the number of recommendation groups to receive tailored music suggestions.
Instructions
Get personalised Apple Music recommendations.
Args: limit: Number of recommendation groups to return, 1ā10 (default 5).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
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}")