statements
Relevés mensuels (revenus et écoutes par mois), solde et versements. Clients et artistes/labels directs : solde chez HILLS et retraits.
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. |
Exemple d’appel
Les assistants font cet appel pour vous ; voici ce qui est envoyé à https://mcp.hillsmusic.com en JSON-RPC.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "statements",
"arguments": {
"months": 12
}
}
}
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.