# statements

> Relatórios mensais (receita e streams por mês), o saldo e os pagamentos. Clientes e artistas/gravadoras diretos: saldo com a HILLS e saques.

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

Ferramenta `statements` · Somente leitura · Todas as contas com acesso ao MCP · Permissão de função: `royalties.view`, `payouts.view`

Relatórios mensais (receita e streams por mês), o saldo e os pagamentos. Clientes e artistas/gravadoras diretos: saldo com a HILLS e saques. Artistas/gravadoras vinculados a um cliente: o que o cliente já pagou a eles; a parte deles, os pagamentos a caminho e o que o cliente deve, apenas quando o cliente mostra o saldo aos seus artistas. Equipe da HILLS: os relatórios de uma conta por account_id (royalties.view; saldo e pagamentos com payouts.view) ou, sem ele, as importações recentes de relatórios das plataformas.

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

## Argumentos

| Argumento | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `months` | integer (1–36) | Não | Quantos meses para trás (máximo 36). Padrão: 12. |
| `account_id` | integer | Não | Só para a equipe da HILLS: a conta a consultar. |

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

## Exemplo de chamada

Os assistentes fazem esta chamada por você; é isto que vai para `https://mcp.hillsmusic.com` via JSON-RPC.

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

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

## Resultado

Um resumo de uma linha em texto e, em seguida, os mesmos dados em JSON em `structuredContent`, com estes campos:

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `currency` | `USD` |  |
| `account` | object ou null |  |
| `months` | array de object |  |
| `balance` | object ou null |  |
| `payouts` | array de object |  |
| `imports` | array de object |  |
| `note` | string |  |

Uma recusa (sem permissão, não encontrado, entrada inválida) volta como erro da ferramenta (`isError: true`), com um texto que explica o motivo.

Fonte: https://developer.hillsmusic.com/pt/mcp/statements/