# search_catalog

> Encontre lançamentos e faixas por título, artista, selo, ISRC ou UPC, e opcionalmente por status.

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

Ferramenta `search_catalog` · Somente leitura · Todas as contas com acesso ao MCP · Permissão de função: `releases.view`

Encontre lançamentos e faixas por título, artista, selo, ISRC ou UPC, e opcionalmente por status. Retorna ids de lançamento para release_status e streams_and_revenue, e as faixas que corresponderam. Deixe query vazio para listar os lançamentos atualizados mais recentemente.

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

## Argumentos

| Argumento | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `query` | string | Não | Título, artista, selo, ISRC (ex.: USRC17607839) ou UPC. Vazio lista os lançamentos recentes. |
| `status` | `draft` \| `in_review` \| `changes_requested` \| `approved` \| `live` \| `archived` \| `taken_down` \| `rejected` | Não | Apenas lançamentos neste status. in_review = enviado, aguardando revisão; live = aprovado e no ar em pelo menos uma plataforma; rejected = changes_requested (nome antigo). |
| `limit` | integer (1–50) | Não | Resultados por página (máximo 50). Padrão: 20. |
| `offset` | integer (0–5000) | Não | Pula esta quantidade de resultados (de next_offset). Padrão: 0. |

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

## Exemplo de chamada

Os assistentes fazem esta chamada por você; é isto que vai para `https://mcp.hillsmusic.com` via 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

Um resumo de uma linha em texto e, em seguida, os mesmos dados em JSON em `structuredContent`, com estes campos:

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `total` | number |  |
| `offset` | number |  |
| `next_offset` | number ou null |  |
| `releases` | array de object |  |

Uma recusa (sem permissão, não encontrado, entrada inválida) volta como erro da ferramenta (`isError: true`), com um texto que explica o motivo.

Fonte: https://developer.hillsmusic.com/pt/mcp/search-catalog/