You're viewing a demo portfolio

Join the waitlist
PRSM

get_recommendations

Active

Tool of FreqBlog Music Metadata

declared in 1.27.2

Recommended tracks for one or more seed tracks — the drop-in for Spotify's removed GET /v1/recommendations. Blends up to 5 catalog seed tracks into a single point in audio-feature space and returns the nearest catalogue tracks, RE-RANKED by genre affinity (so a feature-close cross-genre track doesn't outrank same-genre picks). Returns `seeds` (each {id, found}), `count`, and `tracks` (each {track, score}). `score` is the raw audio-feature cosine similarity in [0,1]; genre affinity influences the ORDER, not the score, so the list is NOT strictly score-descending. seed_tracks are catalog itunes_track_ids from search_catalog or the itunes_track_id field of a get_audio_features result. Costs 2 quota units.

Parameters schema

{
  "type": "object",
  "title": "get_recommendationsArguments",
  "required": [
    "seed_tracks"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of recommendations to return (default 20)."
    },
    "seed_tracks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Seed Tracks",
      "maxItems": 5,
      "minItems": 1,
      "description": "1-5 catalog itunes_track_ids to base recommendations on, e.g. ['apple_ad1829eeccb70f9a'] (blended into a feature-space centroid)."
    },
    "exclude_seed_artists": {
      "type": "boolean",
      "title": "Exclude Seed Artists",
      "default": false,
      "description": "Drop tracks by any of the seed artists (default false)."
    }
  }
}

What this tool wraps· 1 endpoint

min confidence0.700.50

Parent server

FreqBlog Music Metadata

1/7 registries
View full server →
get_recommendations — FreqBlog Music Metadata — PRSM MCP