# search_catalog

> Recherche des sorties et des titres par intitulé, artiste, label, ISRC ou UPC, éventuellement par statut.

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

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

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

## Exemple d’appel

Les assistants font cet appel pour vous ; voici ce qui est envoyé à `https://mcp.hillsmusic.com` en JSON-RPC.

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

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

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

Source: https://developer.hillsmusic.com/fr/mcp/search-catalog/