# statements

> Monatliche Abrechnungen (Erlöse und Streams pro Monat), das Guthaben und die Auszahlungen.

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

Tool `statements` · Nur lesend · Jedes Konto mit MCP-Zugang · Rollenberechtigung: `royalties.view`, `payouts.view`

Monatliche Abrechnungen (Erlöse und Streams pro Monat), das Guthaben und die Auszahlungen. Kunden sowie direkte Artists und Labels: Guthaben bei HILLS und Auszahlungen. Artists und Labels unter einem Kunden: was der Kunde ihnen ausgezahlt hat; ihren Anteil, laufende Auszahlungen und offene Beträge des Kunden nur dann, wenn der Kunde seinen Artists ihr Guthaben anzeigt. HILLS-Team: die Abrechnungen eines Kontos per account_id (royalties.view; Guthaben und Auszahlungen mit payouts.view) oder ohne account_id die letzten importierten Store-Abrechnungen.

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

## Argumente

| Argument | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `months` | integer (1–36) | Nein | Wie viele Monate zurück (max. 36). Standard: 12. |
| `account_id` | integer | Nein | Nur HILLS-Team: das gewünschte Konto. |

<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": "statements",
    "arguments": {
      "months": 12
    }
  }
}
```

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

## Ergebnis

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `currency` | `USD` |  |
| `account` | object oder null |  |
| `months` | Array aus object |  |
| `balance` | object oder null |  |
| `payouts` | Array aus object |  |
| `imports` | Array aus object |  |
| `note` | string |  |

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/statements/