# statements

> Relevés mensuels (revenus et écoutes par mois), solde et versements. Clients et artistes/labels directs : solde chez HILLS et retraits.

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

Outil `statements` · Lecture seule · Tous les comptes ayant accès au MCP · Permission de rôle : `royalties.view`, `payouts.view`

Relevés mensuels (revenus et écoutes par mois), solde et versements. Clients et artistes/labels directs : solde chez HILLS et retraits. Artistes/labels rattachés à un client : ce que le client leur a versé ; leur part, les versements en cours et ce que le client leur doit, uniquement si le client montre leur solde à ses artistes. Personnel HILLS : les relevés d’un compte via account_id (royalties.view ; solde et versements avec payouts.view) ou, sans account_id, les derniers imports de relevés de plateformes.

## Arguments

| Argument | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `months` | integer (1–36) | Non | Nombre de mois d’historique (36 maximum). 12 par défaut. |
| `account_id` | integer | Non | Personnel HILLS uniquement : le compte à consulter. |

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

<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 |
| --- | --- | --- |
| `currency` | `USD` |  |
| `account` | object ou null |  |
| `months` | tableau de object |  |
| `balance` | object ou null |  |
| `payouts` | tableau de object |  |
| `imports` | tableau de object |  |
| `note` | string |  |

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