Dunning Letters MCP

Cobre faturas vencidas: lembrete 1, lembrete 2, aviso final, datas de escalonamento e antiguidade, direto do chat.

Documentação

Lembretes automáticos de pagamento para faturas vencidas

Servidor MCP para cartas de cobrança e lembretes de pagamento de faturas vencidas: lembrete, aviso final e envelhecimento. Cobrança de faturas vencidas em uma escada ancorada na data de vencimento: lembrete 1, lembrete 2, aviso final, com o envelhecimento e a lista de cobrança do dia.

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/dunning-letters — 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 (página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token como 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/dunning-letters 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/dunning-letters/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 dunning-letters.mcpb do último lançamento 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 extra.

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

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

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

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

dunning-letters demo

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

No Registro Oficial de MCP (io.github.theluckystrike/dunning-letters). Cobre faturas vencidas sem perder o fio da meada. Registre uma fatura não paga, cliente, referência, valor em centavos inteiros, moeda, data de vencimento, e o servidor executa a escada de escalada: lembrete 1 (educado, vencimento + 7 dias), lembrete 2 (firme, com a nota de juros de atraso, vencimento + 14) e o aviso final (redação pré-ação, vencimento + 21; os intervalos são configuráveis por fatura). Para cada etapa, ele gera a carta, em Markdown ou como uma página HTML imprimível autossuficiente. Ele registra o que você enviou e quando, lista tudo o que está vencido com dias de atraso e etapa, envelhece todo o registro em faixas atuais/30/60/90+ e responde "o que preciso enviar hoje". Nada é enviado por e-mail ou para qualquer lugar: este servidor produz o texto da carta, e o envio é uma ação sua.

Construído por theluckystrike.

A publicação no npm para @theluckystrike/mcp-dunning-letters está pendente, então npx -y @theluckystrike/mcp-dunning-letters retorna 404 hoje. Até lá, 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": {
    "dunning-letters": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-dunning-letters"]
    }
  }
}

Claude Code

claude mcp add dunning-letters -- npx -y @theluckystrike/mcp-dunning-letters

Cursor

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

Ferramentas

ferramenta	o que faz
`invoice_register`	Começa a cobrar uma fatura não paga: cliente, referência, valor, moeda, data de vencimento. Retorna `DUN-YYYY-NNNN` e as três datas de escalada
`payment_record`	Registra dinheiro recebido, total ou parcial. Um pagamento parcial reduz o que a próxima carta pede; cobrir o saldo encerra a escada
`letter_render`	Gera a carta de cobrança para a etapa atual — lembrete 1, lembrete 2 ou aviso final — como Markdown ou HTML imprimível autossuficiente. Nada é enviado por e-mail: você envia o texto que ele produz
`letter_sent`	Registra que uma carta realmente foi enviada, com sua data, para que a escada avance. As cartas saem em ordem
`overdue_list`	Cada fatura não paga após a data de vencimento: dias de atraso, valor em aberto, cartas enviadas, o que vence a seguir, do pior para o melhor
`aging_summary`	Todo o registro em faixas atuais/1-30/31-60/61-90/91+, contagens e totais em centavos inteiros, por moeda
`chase_today`	A lista de cobrança do dia: quais faturas cruzam um limite de escalada hoje, qual carta enviar para cada uma, o que vence a seguir
`invoice_status`	Uma fatura cobrada em detalhes: pagamentos, cartas, cronograma, próxima ação
`invoice_delete`	Exclui uma fatura inserida incorretamente. O id não é reemitido
`license_status` / `license_activate`	Gratuito ou Pro, e a chave

Gratuito vs Pro

	Gratuito	Pro
Faturas não pagas cobradas de uma vez	3	Ilimitado
Todas as três cartas, ambos os formatos	Sim	Sim
Resumo de envelhecimento e lista de cobrança do dia	Sim	Sim
Acúmulo de juros de atraso nas cartas	Sim	Sim
Registro de pagamentos e histórico	Sim	Sim

O limite é sobre quantas cobranças rodam de uma vez, nunca sobre as cartas ou o envelhecimento: três inadimplentes levados do primeiro lembrete ao aviso final é uma lista de cobrança real, e uma fatura que é paga libera sua vaga. O que é medido é a amplitude; uma quarta cobrança simultânea é uma carga de trabalho de cobrança, não o mês de um freelancer.

Obtenha o Pro: https://mcp.zovo.one/buy/dunning-letters, US$ 19 únicos para este servidor, ou US$ 39 para o pacote.

Uma percepção medida

A escada é ancorada na data de vencimento, não na última carta, e as duas se afastam exatamente quando a cobrança está indo mal.

A cobrança trabalhada em test/_client.mjs: USD 1.250,00 com vencimento em 01/06/2026, intervalos 7/14/21, então as cartas vencem em 08/06, 15/06 e 22/06, independentemente de algo ter sido enviado. Se o lembrete 1 realmente sair atrasado, digamos 20/06, doze dias após sua data, uma escada ancorada na carta anterior empurraria o aviso final para 11/07. Esta não: 22/06 permanece, porque a obrigação do cliente foi fixada pela data de vencimento, não por quando você se dispôs a escrever. Registrar um envio move apenas qual etapa vem a seguir; nunca move o cronograma. As cartas também são estritamente sequenciais: uma fatura com 60 dias de atraso sem nada enviado ainda deve o lembrete 1, porque um aviso final sem um lembrete educado anterior soa como ameaça, não como cobrança.

Os juros de atraso são medidos da mesma forma, uma vez: juros simples, pro-rata em um mês de 30 dias, sobre o valor em aberto no dia em que a carta é escrita, arredondados uma vez para a unidade menor. Na cobrança trabalhada, isso é 125.000 unidades menores a 2% por 30 dias de atraso, exatamente 2.500, e após um pagamento parcial de 50.000, é 1.500 sobre os 75.000 restantes, então o aviso final pede 76.500 e nenhum valor inventado a mais.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/dunning-letters/. Dois arquivos: invoices.json, counter.json. Nada é enviado a lugar algum, sem conta, sem chave de API, sem chamada de rede neste servidor, e as cartas são renderizadas em texto para você enviar; este servidor não possui credenciais de e-mail e não as quer. As chaves de licença são verificadas offline.

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

Perguntas frequentes

Existe um servidor MCP para lembretes de pagamento ou cartas de cobrança?

Sim. O servidor dunning-letters em mcp.zovo.one automatiza o acompanhamento de contas a receber: sequências de lembretes em camadas (amigável, firme, final), cartas em PDF imprimíveis, envelhecimento por cliente. Camada gratuita, endpoint remoto hospedado.

Como envio lembretes de pagamento pelo Claude?

Conecte https://mcp.zovo.one/mcp/dunning-letters e diga: 'Liste faturas vencidas e redija um lembrete firme para a Acme.' A carta segue a sequência padrão em camadas e exporta como PDF.

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 de documentação MCP: https://gitmcp.io/theluckystrike/mcp-dunning-letters