Loan and Lease Schedules MCP

Cronogramas de empréstimos e arrendamentos a partir do Claude: pagamento, divisão de juros, liquidação antecipada. Tudo local.

GitHubExperimente este MCPPatrocinado

Documentação

mcp-amortization

Servidor MCP para cronogramas de amortização de empréstimos e arrendamentos. Cronogramas de empréstimos e arrendamentos a partir dos termos do contrato, até a unidade monetária mínima.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente do Model Context Protocol. Roda na sua própria máquina, ou hospedado sem instalação.

Página do produto: https://mcp.zovo.one/s/amortization — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (a página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token em JSON); um token anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/amortization via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/amortization/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, então o token não é opcional.

Claude Desktop, um clique. Baixe amortization.mcpb da última versão e clique duas vezes nele.

A partir do código-fonte. O espelho é autossuficiente: cada dependência @theluckystrike/* é incluída, então um clone novo compila sem configuração adicional.

git clone https://github.com/theluckystrike/mcp-amortization.git
cd mcp-amortization
npm install && npm run build

Em seguida, aponte seu cliente para o ponto de entrada compilado:

{
  "mcpServers": {
    "amortization": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-amortization/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-amortization ainda não está publicado no npm, então um comando npx -y @theluckystrike/mcp-amortization falhará. Os três caminhos acima são os que funcionam e cada um é testado pela CI.

amortization demo

Espelho somente leitura de mcp-servers/servers/amortization. Veja MIRROR.md.

No Registro MCP oficial (io.github.theluckystrike/amortization). Cronogramas de empréstimos e arrendamentos para um assistente de IA. Dê a ele os termos de um contrato de crédito, o valor, a taxa anual nominal em pontos-base, a frequência de capitalização de juros, a frequência de vencimento dos pagamentos, o prazo em períodos, o método, qualquer taxa de contratação e qualquer pagamento final, e ele calcula o pagamento, a taxa anual efetiva e o cronograma período por período: saldo inicial, pagamento, juros, principal, saldo final. Ele responde quanto custaria e quanto economizaria quitar antecipadamente, e devolve a partida dobrada para um pagamento nos mesmos nomes de contas que o livro caixa usa. Tudo está em unidades monetárias inteiras, e cada saldo final atinge exatamente o pagamento final, ou zero. Nada é enviado a lugar algum: o registro é um arquivo na sua máquina.

A publicação no npm para @theluckystrike/mcp-amortization está pendente, então npx -y @theluckystrike/mcp-amortization retorna 404 hoje. Até lá, o pacote de um clique .mcpb ou um clone+compilação é o caminho que funciona.

Instalação

Claude Desktop, macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "amortization": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-amortization"]
    }
  }
}

claude mcp add amortization -- npx -y @theluckystrike/mcp-amortization

Cursor, ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto). Mesma entrada do Claude Desktop.

Ferramentas

Ferramenta	O que faz
`loan_create`	Registra um empréstimo ou arrendamento a partir de seus termos. Retorna `LOAN-YYYY-NNNN`, o pagamento fixo, a taxa anual efetiva e o total de juros
`loan_schedule`	O cronograma: saldo inicial, pagamento, juros, principal, saldo final para cada período, e o total de juros
`loan_repay_early`	O que quitar ou pagar a mais em um período custa: o saldo devedor, a multa, o cronograma restante recalculado e os juros economizados, brutos e líquidos da multa
`loan_journal`	A partida dobrada para um período ou mês: débito em despesa de juros e passivo do empréstimo, crédito em caixa, além de um payload pronto para `expense_add`
`loan_list`	O registro, com o saldo devedor e a próxima data de pagamento em qualquer data
`loan_delete`	Remove um contrato e devolve sua vaga. Recusado, com a entrada nomeada, se um diário já tiver sido retirado dele
`loans_report`	O que é devido por moeda, quando cada próximo pagamento vence, e os juros cobrados em um ano calendário
`license_status`, `license_activate`	Seu nível, e ativação de uma chave Pro

Grátis vs Pro

	Grátis	Pro
Empréstimos no registro	3	Ilimitados
Cronogramas	Ilimitados	Ilimitados
Excluir um contrato (`loan_delete`)	Sim	Sim
Quitação antecipada (`loan_repay_early`)	-	Sim
Diários (`loan_journal`)	-	Sim
Relatório (`loans_report`)	-	Sim

loan_delete é gratuito de propósito. O limite está nos contratos mantidos, então registrar o mesmo arrendamento duas vezes custaria duas das três vagas sem volta, exceto com uma chave; uma duplicata é recusada por loan_create antes que qualquer coisa seja gravada, nomeando o registro que ela corresponde, e qualquer coisa já no registro volta com loan_delete. Um empréstimo do qual um diário já foi retirado é recusado, e nomeado, porque essas linhas já estão no razão de alguém.

O cronograma nunca é medido. O pagamento e os juros são a pergunta que este servidor existe para responder, e um nível gratuito que esconde a resposta é uma demonstração. O medidor está no número de contratos mantidos, que é a unidade de trabalho.

Obtenha Pro: https://mcp.zovo.one/buy/amortization, $19 único para este servidor, ou $39 para o pacote.

Uma percepção medida

Citar uma taxa por trimestre como a taxa nominal sobre quatro vale 1,0 por cento dos juros, a favor do credor. Pegue EUR 10.000 a uma taxa nominal de 12 por cento capitalizada MENSALMENTE, paga em quatro parcelas trimestrais. A taxa para um trimestre é a taxa equivalente, (1 + 0.12/12)^3 - 1 = 3.0301 por cento, não 0.12/4 = 3.0000 por cento. Essa diferença de 3 pontos-base define o pagamento em EUR 2.692,21 em vez de EUR 2.690,27 e o total de juros em EUR 768,84 em vez de EUR 761,08: EUR 7,76 a mais, 1,0 por cento de toda a conta de juros, em um empréstimo de um ano de dez mil. As duas taxas parecem idênticas em uma cotação e divergem no cronograma, e é por isso que este servidor passa cada taxa equivalente pelo relógio de capitalização e imprime a taxa periódica que usou com seis casas decimais.

A mesma aritmética é o motivo pelo qual a taxa anual efetiva é relatada ao lado da nominal em cada empréstimo: uma taxa nominal de 12 por cento capitalizada mensalmente é uma taxa efetiva de 12,68 por cento, e 0,68 de um por cento é a parte do preço que a taxa de destaque não carrega.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/amortization/. Dois arquivos: loans.json e counter.json. Nenhuma chamada de rede é feita por este servidor, para nenhuma ferramenta. Nenhum cronograma é armazenado: cada linha é derivada dos termos da chamada, porque um cronograma armazenado é uma segunda cópia de um valor que a taxa e o prazo já decidem, e a cópia é a que acaba sendo acreditada depois que alguém edita a taxa.

Construído por theluckystrike. https://github.com/theluckystrike

Use estas documentações como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação:

URL MCP das documentações: https://gitmcp.io/theluckystrike/mcp-amortization