Dunning Letters MCP

Persigue facturas vencidas: recordatorio 1, recordatorio 2, aviso final, fechas de escalamiento y antigüedad, directamente desde el chat.

GitHubPrueba este MCPPatrocinado

Documentación

Recordatorios automáticos de pago para facturas vencidas

Servidor MCP para cartas de cobro y recordatorios de pago de facturas vencidas: recordatorio, aviso final y antigüedad. Persigue facturas vencidas en una escalera anclada a la fecha de vencimiento: recordatorio 1, recordatorio 2, el aviso final, con la antigüedad y la lista de cobros del día.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Model Context Protocol. Se ejecuta en tu propia máquina, o alojado sin instalación.

Página del producto: https://mcp.zovo.one/s/dunning-letters — qué hace, las herramientas que expone y un endpoint de token en vivo.

Instalación

Alojado, nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o https://mcp.zovo.one/mcp/token (el mismo token como JSON); se emite uno anónimo gratuito al instante y una clave Pro funciona de la misma manera. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/dunning-letters a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar encabezados, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/dunning-letters/t/<token>. Ambas formas funcionan. La URL desnuda sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga dunning-letters.mcpb desde la última versión y haz doble clic en él.

Desde el código fuente. El espejo es autocontenido: cada dependencia de @theluckystrike/* está incluida, por lo que un clon nuevo se compila sin configuración adicional.

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

Luego apunta tu cliente al punto de entrada compilado:

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

@theluckystrike/mcp-dunning-letters aún no está publicado en npm, por lo que un comando npx -y @theluckystrike/mcp-dunning-letters fallará. Las tres rutas anteriores son las que funcionan y cada una es verificada por CI.

dunning-letters demo

Espejo de solo lectura de mcp-servers/servers/dunning-letters. Consulta MIRROR.md.

En el Registro oficial de MCP (io.github.theluckystrike/dunning-letters). Persigue facturas vencidas sin perder el hilo. Registra una factura impaga, cliente, referencia de factura, monto en centavos enteros, moneda, fecha de vencimiento, y el servidor ejecuta la escalera de escalamiento: recordatorio 1 (cortés, vencimiento + 7 días), recordatorio 2 (firme, con la nota de cargos por mora, vencimiento + 14), y el aviso final (redacción previa a la acción, vencimiento + 21; los intervalos son configurables por factura). Para cada etapa genera la carta, como Markdown o como una página HTML imprimible autocontenida. Registra lo que enviaste y cuándo, lista todo lo vencido con días de retraso y etapa, clasifica todo el registro en categorías actual/30/60/90+, y responde "qué necesito enviar hoy". No se envía nada por correo ni a ningún lugar: este servidor produce el texto de la carta, y enviarlo es tu acción.

Creado por theluckystrike.

La publicación en npm para @theluckystrike/mcp-dunning-letters está pendiente, por lo que npx -y @theluckystrike/mcp-dunning-letters devuelve 404 hoy. Hasta entonces, un clon + compilación es la ruta que funciona.

Instalación

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) o .cursor/mcp.json (proyecto), misma entrada que Claude Desktop.

Herramientas

herramienta	qué hace
`invoice_register`	Comienza a perseguir una factura impaga: cliente, referencia, monto, moneda, fecha de vencimiento. Devuelve `DUN-YYYY-NNNN` y las tres fechas de escalamiento
`payment_record`	Registra dinero recibido, total o parcial. Un pago parcial reduce lo que pide la siguiente carta; cubrir el saldo cierra la escalera
`letter_render`	Genera la carta de cobro para la etapa actual — recordatorio 1, recordatorio 2 o el aviso final — como Markdown o HTML imprimible autocontenido. No se envía nada por correo: tú envías el texto que produce
`letter_sent`	Registra que una carta realmente salió, con su fecha, para que la escalera avance. Las cartas salen en orden
`overdue_list`	Cada factura impaga después de su fecha de vencimiento: días de retraso, saldo pendiente, cartas enviadas, qué vence a continuación, peor primero
`aging_summary`	Todo el registro en categorías actual/1-30/31-60/61-90/91+, conteos y totales en centavos enteros, por moneda
`chase_today`	La lista de cobros del día: qué facturas cruzan un umbral de escalamiento hoy, qué carta enviar a cada una, qué vence a continuación
`invoice_status`	Una factura perseguida en detalle: pagos, cartas, calendario, próxima acción
`invoice_delete`	Elimina una factura ingresada por error. El id no se reemite
`license_status` / `license_activate`	Gratis o Pro, y la clave

Gratis vs Pro

	Gratis	Pro
Facturas impagas perseguidas a la vez	3	Ilimitadas
Las tres cartas, ambos formatos	Sí	Sí
Resumen de antigüedad y lista de cobros del día	Sí	Sí
Acumulación de cargos por mora en las cartas	Sí	Sí
Registro de pagos e historial	Sí	Sí

El límite está en cuántos cobros se ejecutan a la vez, nunca en las cartas o la antigüedad: tres morosos llevados del primer recordatorio al aviso final es una lista de cobros real, y una factura que se paga libera su espacio. Lo que se mide es la amplitud: un cuarto cobro concurrente es una carga de gestión de cobranzas, no el mes de un autónomo.

Obtén Pro: https://mcp.zovo.one/buy/dunning-letters, $19 único por este servidor, o $39 por el paquete.

Una perspectiva medida

La escalera está anclada a la fecha de vencimiento, no a la última carta, y ambas se separan exactamente cuando el cobro va mal.

El cobro trabajado en test/_client.mjs: USD 1,250.00 con vencimiento 2026-06-01, intervalos 7/14/21, por lo que las cartas vencen el 06-08, 06-15 y 06-22 se envíen o no. Si el recordatorio 1 sale tarde, digamos el 06-20, doce días después de su fecha, una escalera anclada a la carta anterior empujaría el aviso final al 07-11. Esta no: el 06-22 se mantiene, porque la obligación del cliente quedó fijada por la fecha de vencimiento, no por cuándo te diste tiempo de escribir. Registrar un envío solo mueve qué etapa sigue; nunca mueve el calendario. Las cartas también son estrictamente secuenciales: una factura con 60 días de retraso sin nada enviado aún debe el recordatorio 1, porque un aviso final sin una carta cortés previa se lee como una amenaza, no como un cobro.

El cargo por mora se mide de la misma manera, una vez: interés simple, prorrateado sobre un mes de 30 días, sobre el monto pendiente el día en que se escribe la carta, redondeado una vez a la unidad menor. En el cobro trabajado eso es 125,000 unidades menores al 2% sobre 30 días de retraso, 2,500 exactamente, y después de un pago parcial de 50,000 es 1,500 sobre los 75,000 que quedan, por lo que el aviso final pide 76,500 y ninguna cifra inventada más.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/dunning-letters/. Dos archivos: invoices.json, counter.json. No se envía nada a ningún lugar, sin cuenta, sin clave API, sin llamadas de red en este servidor en absoluto, y las cartas se renderizan como texto para que tú las envíes; este servidor no tiene credenciales de correo ni las quiere. Las claves de licencia se verifican sin conexión.

Creado por theluckystrike. https://github.com/theluckystrike

Preguntas frecuentes

¿Existe un servidor MCP para recordatorios de pago o cartas de cobro?

Sí. El servidor dunning-letters en mcp.zovo.one automatiza el seguimiento de cuentas por cobrar: secuencias de recordatorios escalonados (amable, firme, final), cartas PDF imprimibles, antigüedad por cliente. Nivel gratuito, endpoint remoto alojado.

¿Cómo envío recordatorios de pago desde Claude?

Conecta https://mcp.zovo.one/mcp/dunning-letters y di: 'Lista las facturas vencidas y redacta un recordatorio firme para Acme.' La carta sigue la secuencia estándar de niveles y se exporta como PDF.

Usa estos documentos como servidor MCP

Cualquier cliente MCP (Claude, Cursor, Windsurf, VS Code) puede leer la documentación de este repositorio directamente a través de GitMCP — sin instalación:

URL de documentos MCP: https://gitmcp.io/theluckystrike/mcp-dunning-letters