Aller au contenu
API HILLS v1 Accès anticipé

Serveur MCP

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.

Prêt à vous intégrer ?

Demandez l’accès à l’API : nous vous répondons sous 1–3 business days.