# get_recommendations

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, genre_relation}; each track carries its genre). genre_relation is "same", "compatible" (different but mixable family), "cross" (unrelated), or "unknown" (either side has no mapped genre), measured against the PRIMARY seed — the first of your seed_tracks we could actually use, so reordering seed_tracks changes it and a skipped seed never becomes the reference. With a SINGLE seed the field is the ranking's own verdict, so it explains the order (same as suggest_next_track). With SEVERAL seeds the ranking considers ALL of them while the label stays relative to your primary seed, so a "cross" label on a multi-seed call does NOT mean the track was pushed down — it may share a family with another of your seeds. 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. Use cross_genre=strict to return same-genre-family tracks ONLY (off-genre dropped server-side), or allow to disable the genre ranking. seed_tracks are catalog itunes_track_ids from search_catalog or the itunes_track_id field of a get_audio_features result. NO id? Pass track (+ optional artist) instead and we resolve the name to the best catalog match and seed on it — the resolved track is echoed back as seed_query; seed_tracks wins if both are given. TUNING: min/max are HARD filters and target is a preference (nearer ranks higher, nothing removed), over acousticness, danceability, duration_ms, energy, instrumentalness, liveness, loudness, popularity, speechiness, tempo and valence. e.g. min={"tempo": 100}, max={"tempo": 130}, target={"energy": 0.8} for energetic 100-130 BPM tracks. When you tune, the response adds a filters block saying what applied, how many tracks each bound removed (dropped_by) and whether the bounds ran out of catalogue before limit (limit_reached) — if the list comes back short, read that BEFORE assuming the catalogue is thin. Costs 2 quota units.

Agent View of the PolicyLayer registry record for `get_recommendations`. HTML page: https://policylayer.com/tools/com-freqblog-music-metadata/get-recommendations

## Facts

- Tool: `get_recommendations`
- Server: FreqBlog Music Metadata (`https://mcp.freqblog.com/mcp`) — https://policylayer.com/tools/com-freqblog-music-metadata.md
- Homepage: https://github.com/https://mcp.freqblog.com/mcp
- Risk category: Read (Low risk)
- Registry record: grade D, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 9
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `max` | object | no | HARD upper bounds, e.g. {'tempo': 130}. Same attributes as `min`. Combine the two for a range. |
| `min` | object | no | HARD lower bounds, e.g. {'tempo': 100, 'energy': 0.5}. Tracks below the bound — and tracks we hold no analysed value for — are dropped. Attributes: acousticness |
| `limit` | integer | no | Number of recommendations to return (default 20). |
| `track` | object | no | Seed by track NAME instead of an id — resolved to the best catalog match (echoed back as seed_query). Pair with artist to disambiguate. Ignored when seed_tracks |
| `artist` | object | no | Artist name narrowing the track seed (case-insensitive). |
| `target` | object | no | PREFERRED values, e.g. {'energy': 0.8}. Tracks nearer the value rank higher; unlike min/max nothing is removed. Same attributes as `min`. |
| `cross_genre` | string | no | Genre handling (mirrors suggest_next_track): 'auto' (default) re-ranks by genre affinity so a feature-close cross-genre track can't outrank same-genre picks; 's |
| `seed_tracks` | object | no | 1-5 catalog itunes_track_ids to base recommendations on, e.g. ['apple_ad1829eeccb70f9a'] (blended into a feature-space centroid). Omit and use track(+artist) to |
| `exclude_seed_artists` | boolean | no | Drop tracks by any of the seed artists (default false). |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_recommendations",
    "arguments": {}
  }
}
```

## Why get_recommendations is rated Low

Even though get_recommendations only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

## Use case

AI agents call get_recommendations to retrieve information from FreqBlog Music Metadata without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches FreqBlog Music Metadata:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "get_recommendations": {}
  }
}
```

## Other tools on FreqBlog Music Metadata (11)

- `build_setlist` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/build-setlist.md
- `find_compatible_keys` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/find-compatible-keys.md
- `find_tracks_by_bpm` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/find-tracks-by-bpm.md
- `find_tracks_by_key` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/find-tracks-by-key.md
- `get_audio_features` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/get-audio-features.md
- `get_audio_features_batch` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/get-audio-features-batch.md
- `get_related_artists` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/get-related-artists.md
- `score_transition` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/score-transition.md
- `search_catalog` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/search-catalog.md
- `suggest_next_track` — Read — https://policylayer.com/tools/com-freqblog-music-metadata/suggest-next-track.md
- `tag_track` — Write — https://policylayer.com/tools/com-freqblog-music-metadata/tag-track.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-freqblog-music-metadata · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-freqblog-music-metadata