search_catalog
Recherche des sorties et des titres par intitulé, artiste, label, ISRC ou UPC, éventuellement par statut.
Outil search_catalog · Lecture seule · Tous les comptes ayant accès au MCP · Permission de rôle : releases.view
Recherche des sorties et des titres par intitulé, artiste, label, ISRC ou UPC, éventuellement par statut. Renvoie les identifiants de sorties à utiliser avec release_status et streams_and_revenue, ainsi que les titres correspondants. Laissez query vide pour lister les sorties mises à jour le plus récemment.
Arguments
| Argument | Type | Obligatoire | Description |
|---|---|---|---|
query |
string | Non | Intitulé, artiste, label, ISRC (par ex. USRC17607839) ou UPC. Vide, liste les sorties récentes. |
status |
draft | in_review | changes_requested | approved | live | archived | taken_down | rejected |
Non | Uniquement les sorties ayant ce statut. in_review = soumise, en attente de vérification ; live = approuvée et en ligne sur au moins une plateforme ; rejected = changes_requested (ancien nom). |
limit |
integer (1–50) | Non | Résultats par page (50 maximum). 20 par défaut. |
offset |
integer (0–5000) | Non | Nombre de résultats à ignorer (d’après next_offset). 0 par défaut. |
Exemple d’appel
Les assistants font cet appel pour vous ; voici ce qui est envoyé à https://mcp.hillsmusic.com en JSON-RPC.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_catalog",
"arguments": {
"limit": 20,
"offset": 0
}
}
}Résultat
Un résumé d’une ligne en texte, puis les mêmes données en JSON dans structuredContent, avec ces champs :
| Champ | Type | Description |
|---|---|---|
total |
number | |
offset |
number | |
next_offset |
number ou null | |
releases |
tableau de object |
Un refus (pas de permission, introuvable, entrée invalide) revient sous forme d’erreur d’outil (isError: true) dont le texte explique la raison.