Credit Note MCP

Notas de crédito contra una factura o independientes: borradores, finalización, renderizado, totales.

Documentación

mcp-credit-note

Servidor MCP para notas de crédito y abonos contra una factura o independientes. Notas de crédito contra una factura o independientes: borradores, finalización, renderizado y totales, todo en unidades monetarias enteras.

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/credit-note — 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 de 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/credit-note a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar cabeceras, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/credit-note/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 credit-note.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-credit-note.git
cd mcp-credit-note
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

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

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

credit-note demo

Espejo de solo lectura de mcp-servers/servers/credit-note. Consulta MIRROR.md.

En el Registro oficial de MCP (io.github.theluckystrike/credit-note). Notas de crédito (abonos) para freelancers y pequeñas empresas, mantenidas como las mantiene el papeleo. Emite un crédito contra una factura o independiente: el destinatario, el motivo (mercancía devuelta, sobrecargo, corrección de descuento, problema de servicio, otro), líneas de detalle con cantidad, precio unitario y tasa de impuesto, y la moneda. Cada nota de crédito comienza como un borrador que puedes revisar y eliminar; la finalización quema el número final CN-YYYY-NNNN y lo congela, porque una nota de crédito finalizada es un documento que el cliente puede haber visto. Renderízala a Markdown para pegarla en un correo, o a una página HTML imprimible autocontenida, y obtén los totales acreditados por moneda, motivo y mes. Cada importe es un número entero de unidades monetarias, y no se envía nada a ningún lugar.

Creado por theluckystrike.

La publicación en npm para @theluckystrike/mcp-credit-note está pendiente, por lo que npx -y @theluckystrike/mcp-credit-note 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": {
    "credit-note": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-credit-note"]
    }
  }
}

Claude Code

claude mcp add credit-note -- npx -y @theluckystrike/mcp-credit-note

Cursor

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

Herramientas

herramienta	qué hace
`credit_note_create`	Emite una nota de crédito contra una factura o independiente: destinatario, motivo, líneas con cantidad, precio unitario en unidades monetarias y tasa de impuesto, moneda. Devuelve un borrador `CN-DRAFT-YYYY-NNNN`
`credit_note_update`	Revisa un borrador mientras sigue siendo borrador: destinatario, motivo, líneas, moneda, referencia de factura, fecha de emisión o notas. Las nuevas líneas reemplazan a todas las anteriores. Una nota finalizada es rechazada por nombre
`credit_note_finalize`	Quema el número final `CN-YYYY-NNNN` y congela la nota: desde aquí no se puede editar ni eliminar, solo renderizar y listar
`credit_note_list`	Lista notas de crédito con número, destinatario, motivo, estado, fecha de emisión y total. Filtra por destinatario, motivo, estado y período de fecha de emisión
`credit_note_get`	Lee una nota de crédito completa por número CN o id de borrador: cada línea, las líneas de impuesto, los totales, el motivo y las notas
`credit_note_delete`	Elimina un borrador ingresado por error. Una nota finalizada es rechazada: es un documento que el cliente puede haber visto
`credit_note_render`	Renderiza una nota de crédito como Markdown para pegarla en un correo, o como una página HTML imprimible autocontenida. Los borradores se renderizan con un banner de BORRADOR
`credit_note_summary`	Total acreditado por moneda sobre notas finalizadas, desglosado por motivo y por mes, en un período opcional de fecha de emisión
`license_status` / `license_activate`	Gratis o Pro, y la clave

Gratis vs Pro

	Gratis	Pro
Notas de crédito finalizadas	10, de por vida	Ilimitadas
Borradores (`credit_note_create`, `credit_note_update`)	Ilimitados	Ilimitados
Eliminar un borrador (`credit_note_delete`)	Sí	Sí
Listado, lectura (`credit_note_list`, `credit_note_get`)	Ilimitados	Ilimitados
Renderizado (`credit_note_render`)	Ilimitado, pie de página de una línea	Ilimitado, sin pie de página
Totales (`credit_note_summary`)	Ilimitados	Ilimitados

Finalizar es la acción medida porque es lo que convierte un borrador en el documento que ve el cliente. Todo lo demás es gratuito e ilimitado: un nivel gratuito que retiene el documento renderizado o los totales es una demo, y diez notas de crédito finalizadas reales son un año de trabajo para un freelancer que acredita una factura de vez en cuando.

Obtén Pro: https://mcp.zovo.one/buy/credit-note, $19 de pago único para este servidor, o $39 por el paquete.

La regla de redondeo

Cada importe es un número entero de unidades monetarias (céntimos), y el cálculo de líneas está documentado para que el documento impreso se reproduzca en una calculadora:

El precio unitario se ingresa como unidades monetarias enteras, por lo que nada se redondea al ingresar. El bruto de la línea es cantidad x precio unitario, redondeado hacia arriba una vez: gross = round_half_up(quantity * unit_price_minor). Una cantidad entera es exacta; una fraccionaria (2,5 horas a EUR 33,33) cae en el céntimo más cercano, y 2,5 x 3333 = 8332,5 se redondea a 8333, nunca al 8332 bancario.
El impuesto se calcula por línea y se redondea hacia arriba por línea: tax = round_half_up(gross * rate / 100).
El total de la línea es bruto + impuesto, y los totales de la nota son sumas enteras simples de los valores de línea ya redondeados.

Redondea por línea, luego suma: un total nunca puede desviarse de las líneas impresas más allá del redondeo ya visible en esas líneas, por lo que la línea de impuesto al 23% tiene su propia base (solo las líneas al 23%), no sobre el subtotal completo.

Numeración

Los borradores llevan un id CN-DRAFT-YYYY-NNNN que ningún cliente ve. El número final CN-YYYY-NNNN se asigna solo al finalizar, en el año de la fecha de emisión, y el contador se escribe antes del registro, por lo que un fallo quema un número en lugar de reutilizarlo. Como los borradores nunca tienen un número final y las notas finalizadas no se pueden eliminar, la serie final nunca tiene huecos.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/credit-note/. Dos archivos: notes.json, counter.json. No se envía nada a ningún lugar, no hay cuenta, ni clave API ni llamada de red en este servidor. Las claves de licencia se verifican sin conexión. Los renderizados Markdown y HTML se devuelven como texto; este servidor no escribe archivos de documento.

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

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-credit-note