# 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.

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

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.

<a id="arguments"></a>

## 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. |

<a id="example-call"></a>

## 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.

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

<a id="result"></a>

## 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.

Fuente: https://developer.hillsmusic.com/es/mcp/statements/