statements
Monatliche Abrechnungen (Erlöse und Streams pro Monat), das Guthaben und die Auszahlungen.
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.
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. |
Beispielaufruf
Assistenten führen diesen Aufruf für Sie aus; so sieht die an https://mcp.hillsmusic.com gesendete JSON-RPC-Nachricht aus.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "statements",
"arguments": {
"months": 12
}
}
}
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.