Loan and Lease Schedules MCP

Programas de préstamos y arrendamientos desde Claude: pago, división de intereses, liquidación anticipada. Todo local.

Documentación

mcp-amortization

Servidor MCP para calendarios de amortización de préstamos y arrendamientos. Calendarios de préstamos y arrendamientos a partir de los términos del acuerdo, hasta la unidad menor.

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/amortization — 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/amortization 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/amortization/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 amortization.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-amortization.git
cd mcp-amortization
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

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

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

amortization demo

Espejo de solo lectura de mcp-servers/servers/amortization. Ver MIRROR.md.

En el Registro oficial de MCP (io.github.theluckystrike/amortization). Calendarios de préstamos y arrendamientos para un asistente de IA. Dale los términos de un acuerdo de crédito, el monto, la tasa anual nominal en puntos base, la frecuencia de capitalización de intereses, la frecuencia de vencimiento de pagos, el plazo en períodos, el método, cualquier comisión de apertura y cualquier pago global, y calcula el pago, la tasa anual efectiva y el calendario período por período: saldo inicial, pago, interés, principal, saldo final. Responde cuánto costaría y cuánto ahorraría liquidar anticipadamente, y entrega la partida doble para un pago en los mismos nombres de cuenta que usa el libro de caja. Todo está en unidades enteras menores, y cada saldo final alcanza el pago global, o cero, exactamente. Nada se envía a ningún lugar: el registro es un archivo en tu máquina.

La publicación en npm para @theluckystrike/mcp-amortization está pendiente, por lo que npx -y @theluckystrike/mcp-amortization devuelve 404 hoy. Hasta entonces, el paquete de un clic .mcpb o 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": {
    "amortization": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-amortization"]
    }
  }
}

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

Cursor, ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto). Misma entrada que Claude Desktop.

Herramientas

Herramienta	Qué hace
`loan_create`	Registra un préstamo o arrendamiento a partir de sus términos. Devuelve `LOAN-YYYY-NNNN`, el pago nivelado, la tasa anual efectiva y el interés total
`loan_schedule`	El calendario: saldo inicial, pago, interés, principal, saldo final para cada período, y el interés total
`loan_repay_early`	Cuánto cuesta liquidar o pagar de más en un período: el saldo pendiente, la penalización, el calendario restante recalculado y el interés ahorrado, bruto y neto de la penalización
`loan_journal`	La partida doble para un período o un mes: débito a gasto por intereses y pasivo del préstamo, crédito a caja, más un payload listo para `expense_add`
`loan_list`	El registro, con el saldo pendiente y la fecha del próximo pago en cualquier fecha
`loan_delete`	Elimina un acuerdo y devuelve su espacio. Se rechaza, nombrando la entrada, si ya se ha tomado un asiento de diario de él
`loans_report`	Lo que se debe por moneda, cuándo vence cada próximo pago y el interés cobrado en un año calendario
`license_status`, `license_activate`	Tu nivel, y la activación de una clave Pro

Gratis vs Pro

	Gratis	Pro
Préstamos en el registro	3	Ilimitados
Calendarios	Ilimitados	Ilimitados
Eliminar un acuerdo (`loan_delete`)	Sí	Sí
Liquidación anticipada (`loan_repay_early`)	-	Sí
Asientos de diario (`loan_journal`)	-	Sí
Informe (`loans_report`)	-	Sí

loan_delete es gratuito a propósito. El límite está en los acuerdos mantenidos, por lo que registrar el mismo arrendamiento dos veces costaría dos de los tres espacios sin forma de volver atrás salvo una clave; un duplicado es rechazado por loan_create antes de que se escriba nada, nombrando el registro que coincide, y cualquier cosa ya en el registro sale de nuevo con loan_delete. Un préstamo del que ya se ha tomado un asiento de diario se rechaza en su lugar, y se nombra, porque esas líneas ya están en el libro mayor de alguien.

El calendario nunca se mide. El pago y el interés son la pregunta que este servidor existe para responder, y un nivel gratuito que oculta la respuesta es una demostración. El medidor está en el número de acuerdos mantenidos, que es la unidad de trabajo.

Obtén Pro: https://mcp.zovo.one/buy/amortization, $19 único para este servidor, o $39 para el paquete.

Una percepción medida

Cotizar una tasa por trimestre como la tasa nominal sobre cuatro vale 1.0 por ciento del interés, a favor del prestamista. Toma EUR 10,000 a un nominal del 12 por ciento capitalizado MENSUALMENTE, reembolsado en cuatro cuotas trimestrales. La tasa para un trimestre es la tasa equivalente, (1 + 0.12/12)^3 - 1 = 3.0301 por ciento, no 0.12/4 = 3.0000 por ciento. Esa diferencia de 3 puntos base fija el pago en EUR 2,692.21 en lugar de EUR 2,690.27 y el interés total en EUR 768.84 en lugar de EUR 761.08: EUR 7.76 más, 1.0 por ciento de toda la factura de intereses, en un préstamo de un año de diez mil. Las dos tasas se ven idénticas en una cotización y divergen en el calendario, que es por lo que este servidor lleva cada tasa equivalente a través del reloj de capitalización e imprime la tasa periódica que usó con seis decimales.

La misma aritmética es por lo que la tasa anual efectiva se informa junto a la nominal en cada préstamo: un nominal del 12 por ciento capitalizado mensualmente es un efectivo del 12.68 por ciento, y 0.68 de un por ciento es la parte del precio que la tasa principal no lleva.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/amortization/. Dos archivos: loans.json y counter.json. Este servidor no realiza ninguna llamada de red, para ninguna herramienta. No se almacena ningún calendario: cada fila se deriva de los términos de la llamada, porque un calendario almacenado es una segunda copia de una cifra que la tasa y el plazo ya deciden, y la copia es la que se cree después de que alguien edita la tasa.

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

Usa estos documentos como un 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 Docs MCP: https://gitmcp.io/theluckystrike/mcp-amortization