search_catalog
Busca lanzamientos y pistas por título, artista, sello, ISRC o UPC, y opcionalmente por estado.
Herramienta search_catalog · Solo lectura · Todas las cuentas con acceso a MCP · Permiso de rol: releases.view
Busca lanzamientos y pistas por título, artista, sello, ISRC o UPC, y opcionalmente por estado. Devuelve los ids de lanzamiento para release_status y streams_and_revenue, y las pistas que coinciden. Deja query vacío para listar los lanzamientos actualizados más recientemente.
Argumentos
| Argumento | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query |
string | No | Título, artista, sello, ISRC (p. ej., USRC17607839) o UPC. Si está vacío, lista los lanzamientos recientes. |
status |
draft | in_review | changes_requested | approved | live | archived | taken_down | rejected |
No | Solo lanzamientos en este estado. in_review = enviado, pendiente de revisión; live = aprobado y publicado en al menos una plataforma; rejected = changes_requested (nombre antiguo). |
limit |
integer (1–50) | No | Resultados por página (máximo 50). Valor predeterminado: 20. |
offset |
integer (0–5000) | No | Omite este número de resultados (de next_offset). Valor predeterminado: 0. |
Ejemplo de llamada
Los asistentes hacen esta llamada por ti; esto es lo que se envía a https://mcp.hillsmusic.com por JSON-RPC.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_catalog",
"arguments": {
"limit": 20,
"offset": 0
}
}
}Resultado
Un resumen de una línea como texto y, después, los mismos datos en JSON en structuredContent, con estos campos:
| Campo | Tipo | Descripción |
|---|---|---|
total |
number | |
offset |
number | |
next_offset |
number o null | |
releases |
array de object |
Un rechazo (sin permiso, no encontrado, datos incorrectos) vuelve como error de la herramienta (isError: true) cuyo texto explica el motivo.