search_catalog
Encontre lançamentos e faixas por título, artista, selo, ISRC ou UPC, e opcionalmente por status.
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.
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. |
Exemplo de chamada
Os assistentes fazem esta chamada por você; é isto que vai para https://mcp.hillsmusic.com via JSON-RPC.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_catalog",
"arguments": {
"limit": 20,
"offset": 0
}
}
}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.