Ir al contenido
HILLS API v1 Acceso anticipado

Servidor MCP

statements

Liquidaciones mensuales (ingresos y reproducciones por mes), el saldo y los pagos. Socios y artistas o sellos directos: el saldo con HILLS y los retiros.

Herramienta statements · Solo lectura · Todas las cuentas con acceso a MCP · Permiso de rol: royalties.view, payouts.view

Liquidaciones mensuales (ingresos y reproducciones por mes), el saldo y los pagos. Socios y artistas o sellos directos: el saldo con HILLS y los retiros. Artistas o sellos que dependen de un socio: lo que el socio les ha pagado; su parte, los pagos en camino y lo que el socio les debe, solo si el socio muestra el saldo a sus artistas. Personal de HILLS: las liquidaciones de una cuenta por account_id (royalties.view; saldo y pagos con payouts.view) o, sin él, las importaciones recientes de liquidaciones de plataformas.

Argumentos

Argumento Tipo Obligatorio Descripción
months integer (1–36) No Cuántos meses hacia atrás (máximo 36). Valor predeterminado: 12.
account_id integer No Solo personal de HILLS: la cuenta que se consulta.

Ejemplo de llamada

Los asistentes hacen esta llamada por ti; esto es lo que se envía a https://mcp.hillsmusic.com por JSON-RPC.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "statements",
    "arguments": {
      "months": 12
    }
  }
}

Resultado

Un resumen de una línea como texto y, después, los mismos datos en JSON en structuredContent, con estos campos:

Campo Tipo Descripción
currency USD
account object o null
months array de object
balance object o null
payouts array de object
imports array de object
note string

Un rechazo (sin permiso, no encontrado, datos incorrectos) vuelve como error de la herramienta (isError: true) cuyo texto explica el motivo.

¿Listo para integrar?

Solicita acceso a la API y te respondemos en 1 a 3 días hábiles.