Zum Inhalt springen
HILLS API v1 Early Access

MCP-Server

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.

Bereit für die Integration?

Beantragen Sie API-Zugang – wir melden uns innerhalb von 1–3 Werktagen bei Ihnen.