# search_catalog

> Busca lanzamientos y pistas por título, artista, sello, ISRC o UPC, y opcionalmente por estado.

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

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.

<a id="arguments"></a>

## 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. |

<a id="example-call"></a>

## 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.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "limit": 20,
      "offset": 0
    }
  }
}
```

<a id="result"></a>

## 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.

Fuente: https://developer.hillsmusic.com/es/mcp/search-catalog/