Invoice numberer
This MCP server numbers PDF invoices in a batch locally and offline, writing numbered copies and optional ZIP/merged outputs.
Stamp a correlative number on every page of each PDF invoice using a configurable template such as
F-{n:4}.Process absolute PDF file paths or folders of PDFs non-recursively, with natural-name, modified-date, or given-order sorting.
Set starting and/or ending numbers, or use
dry_runto preview assigned numbers without writing files.Control number position from left/right and top/bottom edges in millimeters, plus font, size, color, and an optional background box with color and padding.
Open password-protected PDFs when a password is supplied; numbered copies are saved unprotected.
Write numbered PDFs to a chosen output folder, optionally also create a ZIP and/or a single merged PDF.
Keep originals unchanged and process everything locally without network access.
numerador-facturas
Numera facturas PDF en lote desde el navegador. Estampa un número correlativo
(F-0001, F-0002…) en todas las páginas de cada factura y te devuelve un ZIP listo
para entregar. Todo ocurre del lado del cliente: los PDFs nunca salen de tu equipo.
Resuelve el trámite de foliar o numerar un lote de facturas sin subir documentos sensibles a ningún servicio y sin software de escritorio.
Web: https://nuncaeslupus.github.io/numerador-facturas/
Inicio rápido
make sync # npm install
make dev # servidor localAbre el navegador, arrastra tus PDFs, define la plantilla de numeración y descarga el ZIP.
Related MCP server: invovate-mcp-server
Ejemplo
Plantilla F-{n:4} sobre tres archivos empezando en el número 1:
plantilla "F-{n:4}", número 7 -> F-0007
rango de 3 archivos, inicio 1 -> del 1 al 3
factura-1.pdf -> F-0001_factura-1.pdf
factura-2.pdf -> F-0002_factura-2.pdf
factura-3.pdf -> F-0003_factura-3.pdfEl número se estampa en cada página; la salida es un ZIP con un PDF por factura y/o un único PDF con todas unidas.
Uso
Archivos — elige o arrastra los PDFs. Se ordenan por nombre (orden natural:
2antes que10) o por fecha de modificación; luego puedes reordenarlos arrastrando o con ↑ ↓.Numeración — plantilla con un marcador:
{n:4}rellena con ceros (0007),{n}sin ceros. Indica el número inicial o el final; el otro se calcula según el número de archivos. Si das ambos y no cuadran, avisa.Posición y aspecto — haz clic en la vista previa o escribe la distancia en mm desde la izquierda/derecha y desde arriba/abajo (por defecto, 10 mm de la esquina superior derecha). Así funciona igual en A4 y en recibos más bajos. Fuente, tamaño y color del número, y un recuadro opcional detrás con su color y margen.
Resultado — un ZIP con un PDF por factura (
F-0001_original.pdf) y/o un único PDF con todas juntas.
Los PDFs protegidos se abren: si piden contraseña, la página la pregunta (no se guarda). La copia numerada sale sin protección. Los archivos que no se pueden leer se avisan arriba de la lista y no se numeran.
Disponible en español, inglés, francés, italiano, alemán y chino (según el idioma del
navegador, o el que elijas arriba). La configuración se recuerda en el navegador
(localStorage).
Privacidad
Sitio estático sin backend. La página lleva una Content-Security-Policy que solo permite
cargar recursos del propio sitio, y un test comprueba que el código no hace peticiones de
red (fetch, XHR, WebSocket…).
Usar desde una IA (MCP)
La web no tiene API: lo que usa un LLM es mcp/, un servidor MCP sin UI que
reutiliza el código de src/ y se ejecuta en tu equipo, sin red. La propia web explica cómo
instalarlo y sirve el .mcpb para Claude Desktop y un
llms.txt para los LLM.
Desarrollo
Vite + TypeScript, @cantoo/pdf-lib (pdf-lib con soporte de cifrado) para estampar y unir, pdf.js para la vista previa y fflate para el ZIP.
make sync # npm install
make dev # servidor local
make check # formato, lint, tipos, build y testsLos tests usan PDFs sintéticos. Cada push a main se publica en GitHub Pages
(.github/workflows/deploy.yml).
Este repo sigue el flujo spec → diseño → ejecución de
claude-arsenal: ver
status/specification.md y status/plan.md.
Proyectos relacionados
claude-arsenal — flujo spec-driven para Claude Code y cola de tareas con gates.
drawspec — spec declarativo de diagramas → SVG/PNG/texto limpio, escribible por LLMs; incluye servidor MCP.
doc-control — permite a agentes de IA editar documentos Word como cambios con control de versiones.
literary-critic — análisis de manuscritos con LLM como lo haría un editor profesional.
integral-job-search — búsqueda de empleo centrada en el candidato, dentro de Claude Code.
Licencia
MIT — ver LICENSE.
Available Tools
1 toolnumber_invoicesNumerar facturasA
Stamps a correlative number (F-0001, F-0002…) on every page of each PDF invoice in a batch and writes numbered copies to a new folder. Numera facturas PDF en lote. Runs locally and offline: the PDFs stay on this computer and the originals are not modified.
Inputs: paths (required), end, zip, font, +16 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of misselection between competing tools. Its purpose (batch-numbering PDF invoices) is stated clearly and unambiguously.
The single name 'number_invoices' follows a clean verb_noun snake_case pattern. No competing conventions exist to create inconsistency.
The server has a deliberately narrow, single-purpose scope, so one tool is defensible rather than an oversight. It is on the thin side (no separate preview/configure operations), which keeps it just below a perfect score.
Core behavior (stamp sequential numbers, write to a new folder, leave originals untouched) is covered, but obvious adjacent operations are absent: choosing a prefix or starting number, dry-run/preview, resuming numbering across batches, or undoing a run. Agents can work around these only by post-processing output themselves.
Maintenance
Related MCP Connectors
Create PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local.
Create PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local.
Make PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local.
Add page numbers, Bates numbers or a text watermark to a PDF document right in the chat.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables the generation of professional PDF invoices and their distribution via email using customizable templates. It allows users to create, manage, and send invoices with standard business fields like tax rates and line items through natural language.37 npm2MIT
- AlicenseAqualityDmaintenanceCreate invoices from any MCP client via the Invovate API — compute totals and generate PDF, JSON, or UBL invoices in 11 languages. Exposes four tools: calculate_invoice_totals (no API key needed), generate_invoice_pdf, generate_invoice_ubl, and get_invoice_capabilities.450 npm1MIT
- AlicenseAqualityCmaintenanceTurns invoice details from an MCP client conversation into calculated totals and formatted Excel workbooks in JPY, USD, or EUR, using integer minor-unit arithmetic and grouped tax rounding. Supports mixed tax rates, Excel formulas with cached totals, and A4 print-ready layouts, writing files locally with no network access or API key.2MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to locate invoice files, extract embedded ZUGFeRD/Factur-X XML from PDF/A-3 documents, and validate compliance with § 14 UStG and EN 16931, including direct PDF invoice checks.31MIT