# search_catalog

> Findet Releases und Tracks nach Titel, Artist, Label, ISRC oder UPC, optional nach Status.

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

Tool `search_catalog` · Nur lesend · Jedes Konto mit MCP-Zugang · Rollenberechtigung: `releases.view`

Findet Releases und Tracks nach Titel, Artist, Label, ISRC oder UPC, optional nach Status. Liefert Release-IDs für release_status und streams_and_revenue sowie die passenden Tracks. Lassen Sie query leer, um die zuletzt aktualisierten Releases aufzulisten.

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

## Argumente

| Argument | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `query` | string | Nein | Titel, Artist, Label, ISRC (z. B. USRC17607839) oder UPC. Leer: die neuesten Releases. |
| `status` | `draft` \| `in_review` \| `changes_requested` \| `approved` \| `live` \| `archived` \| `taken_down` \| `rejected` | Nein | Nur Releases mit diesem Status. in_review = eingereicht, wartet auf Prüfung; live = freigegeben und in mindestens einem Store live; rejected = changes_requested (alter Name). |
| `limit` | integer (1–50) | Nein | Ergebnisse pro Seite (max. 50). Standard: 20. |
| `offset` | integer (0–5000) | Nein | So viele Ergebnisse überspringen (aus next_offset). Standard: 0. |

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

## Beispielaufruf

Assistenten führen diesen Aufruf für Sie aus; so sieht die an `https://mcp.hillsmusic.com` gesendete JSON-RPC-Nachricht aus.

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

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

## Ergebnis

Eine einzeilige Zusammenfassung als Text, danach dieselben Daten als JSON in `structuredContent` mit diesen Feldern:

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `total` | number |  |
| `offset` | number |  |
| `next_offset` | number oder null |  |
| `releases` | Array aus object |  |

Eine Ablehnung (keine Berechtigung, nicht gefunden, ungültige Eingabe) kommt als Tool-Fehler (`isError: true`) zurück, dessen Text den Grund nennt.

Quelle: https://developer.hillsmusic.com/de/mcp/search-catalog/