search_catalog
Findet Releases und Tracks nach Titel, Artist, Label, ISRC oder UPC, optional nach Status.
Tool search_catalog · Nur lesend · Jedes Konto mit MCP-Zugang · Rollenberechtigung: releases.view
Findet Releases und Tracks nach Titel, Artist, Label, ISRC oder UPC, optional nach Status. Liefert Release-IDs für release_status und streams_and_revenue sowie die passenden Tracks. Lassen Sie query leer, um die zuletzt aktualisierten Releases aufzulisten.
Argumente
| Argument | Typ | Pflicht | Beschreibung |
|---|---|---|---|
query |
string | Nein | Titel, Artist, Label, ISRC (z. B. USRC17607839) oder UPC. Leer: die neuesten Releases. |
status |
draft | in_review | changes_requested | approved | live | archived | taken_down | rejected |
Nein | Nur Releases mit diesem Status. in_review = eingereicht, wartet auf Prüfung; live = freigegeben und in mindestens einem Store live; rejected = changes_requested (alter Name). |
limit |
integer (1–50) | Nein | Ergebnisse pro Seite (max. 50). Standard: 20. |
offset |
integer (0–5000) | Nein | So viele Ergebnisse überspringen (aus next_offset). Standard: 0. |
Beispielaufruf
Assistenten führen diesen Aufruf für Sie aus; so sieht die an https://mcp.hillsmusic.com gesendete JSON-RPC-Nachricht aus.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_catalog",
"arguments": {
"limit": 20,
"offset": 0
}
}
}Ergebnis
Eine einzeilige Zusammenfassung als Text, danach dieselben Daten als JSON in structuredContent mit diesen Feldern:
| Feld | Typ | Beschreibung |
|---|---|---|
total |
number | |
offset |
number | |
next_offset |
number oder null | |
releases |
Array aus object |
Eine Ablehnung (keine Berechtigung, nicht gefunden, ungültige Eingabe) kommt als Tool-Fehler (isError: true) zurück, dessen Text den Grund nennt.