Pular para o conteúdo
HILLS API v1 Acesso antecipado

Servidor MCP

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.

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.

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.

Exemplo de chamada

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

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

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.

Pronto para integrar?

Solicite acesso à API e retornamos em 1 a 3 dias úteis.