> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiwify.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Financeiro

> As ferramentas de financeiro do MCP da Kiwify, com os escopos e os parâmetros de cada uma.

Cada ferramenta abre com uma tabela:

* **Ferramenta** é o nome que o assistente chama.
* **Operação** diz o que ela faz na conta. **Leitura** só consulta. **Escrita** cria, edita ou exclui. **Pede confirmação**: antes de chamar a ferramenta, o assistente diz o que vai mudar e espera você confirmar. **Envia e-mail**: a ferramenta manda um e-mail para alguém de fora da conta, como um aluno, um participante ou outra loja.
* **Escopo** é a [permissão](https://docs.kiwify.com.br/mcp/permissoes.md) que a conexão precisa ter. As ações sem volta ficam nos escopos que terminam em `:delete`, que vêm desmarcados.

Os parâmetros com **required** são obrigatórios.

## Saldo

| Ferramenta | Operação | Escopo |
| - | - | - |
| `balance` | Leitura | [`finance:read`](https://docs.kiwify.com.br/mcp/permissoes#escopos) |

Mostra o saldo atual da loja conectada numa moeda (BRL quando ausente): disponível, pendente, disponível para saque e reservado para reembolsos pedidos, decimais com centavos. Sacar não está disponível pelo chat: peça ao vendedor que faça no Dashboard.

**Parâmetros**

**currency** `string`

BRL: real; USD: dólar americano; EUR: euro. Valores: `BRL`, `USD`, `EUR`.

## Listar saques e liquidações

| Ferramenta | Operação | Escopo |
| - | - | - |
| `transfers_list` | Leitura | [`finance:read`](https://docs.kiwify.com.br/mcp/permissoes#escopos) |

Lista os saques e as liquidações da loja conectada numa moeda (BRL quando ausente), até 50 por página. `type` é withdraw (saque) ou uma liquidação de recebíveis: external\_liquidation, external\_liquidation\_v2 ou post\_contracted\_liquidation. `amount` é decimal com centavos; as datas são ISO 8601. `date` é o dia do pedido do saque ou o previsto da liquidação, que pode ser futuro com `status` requested. `total` conta as linhas, até 1000. Sacar não está disponível pelo chat: peça ao vendedor que faça no Dashboard.

**Parâmetros**

**currency** `string`

BRL: real; USD: dólar americano; EUR: euro. Valores: `BRL`, `USD`, `EUR`.

**page** `integer`

De 1 a 20. Mínimo: 1. Máximo: 20.

**page\_size** `integer`

Linhas por página, de 1 a 50; o padrão é 50. Mínimo: 1. Máximo: 50.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.