InvoiceFlow MCP

Automatización de facturas impulsada por IA para el Protocolo de Contexto de Modelos (MCP)

InvoiceFlow crea facturas profesionales en PDF, predice el riesgo de pago atrasado mediante IA, envía recordatorios automáticamente, concilia los pagos recibidos con las facturas y realiza un seguimiento de su flujo de caja, todo a través del protocolo MCP.

Características

• Facturas profesionales en PDF con partidas, impuestos, descuentos y multidivisa (10 monedas)

• Predicción de riesgo mediante IA (0-100) basada en el importe de la factura, el historial del cliente, la fecha de vencimiento y el historial de recordatorios

• Recordatorios inteligentes con escalada basada en el nivel de riesgo

• Conciliación de pagos que empareja los pagos recibidos con las facturas por importe + correo electrónico del pagador (independiente de la plataforma: funciona con datos de pago introducidos manualmente o proporcionados por webhooks)

• Informes de flujo de caja con tasa de cobro, ingresos proyectados y desglose por cliente

• Gestión de clientes con seguimiento automático del historial de pagos

• Números de factura secuenciales (INV-2026-0001, INV-2026-0002, ...)

• 10 herramientas MCP + 4 recursos MCP que cubren todo el ciclo de vida de la facturación

Related MCP server: Frihet MCP Server

Inicio rápido

Instalar desde el Marketplace de MCPize

1. Busca InvoiceFlow MCP en mcpize.com

2. Haz clic en Instalar y selecciona tu plan de suscripción

3. Las herramientas y recursos estarán disponibles automáticamente en cualquier cliente compatible con MCP

Construir desde el código fuente

git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run build

Añadir a la configuración de tu cliente MCP:

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

Herramientas

client_manage

Crea un nuevo cliente. Requerido antes de crear facturas.

invoice_create

Crea una factura con partidas. Calcula automáticamente el subtotal, los impuestos, los descuentos y el total. Genera números de factura secuenciales (INV-AAAA-NNNN).

invoice_send

Envía una factura en PDF por correo electrónico (requiere SENDGRID_API_KEY). Actualiza el estado a "enviado".

invoice_list

Filtra facturas por estado, cliente, rango de importe, rango de fechas o estado de vencimiento. Soporta paginación.

invoice_mark_paid

Marca una factura como pagada (total o parcial). Actualiza el historial de pagos del cliente automáticamente.

invoice_remind

Envía un recordatorio de pago. Incrementa el contador de recordatorios. Soporta mensajes personalizados.

invoice_risk

Predicción de riesgo de pago atrasado impulsada por IA (0-100). Devuelve el nivel de riesgo, desglose de factores, acción recomendada y fecha del próximo recordatorio.

cashflow_report

Genera un resumen de flujo de caja: total facturado, cobrado, pendiente, vencido, tasa de cobro y proyección a 30 días.

payment_reconcile

Empareja el pago recibido con la factura por importe y correo electrónico del pagador. Marca automáticamente como pagada.

Recursos

Motor de predicción de riesgos

Califica las facturas de 0 a 100 utilizando 4 factores ponderados:

Niveles de riesgo: Bajo (0-30), Medio (31-60), Alto (61-100)

Configuración

Copia .env.example a .env y establece las variables que necesites:

cp .env.example .env

SendGrid es opcional. InvoiceFlow funciona completamente offline para la creación de facturas, calificación de riesgos, informes de flujo de caja y conciliación. Añade SendGrid cuando desees realizar envíos de correo electrónico.

Hoja de ruta: Sincronización en vivo con Stripe y PayPal

La herramienta payment_reconcile actualmente empareja los importes que tú proporcionas (desde un CSV, un webhook o entrada manual) con las facturas almacenadas. La integración directa con la API de Stripe y PayPal con escuchas de webhooks está planificada para la v2.0 — consulta los problemas para ver el progreso.

Ejemplos de uso

Crear un cliente y una factura

> Create a client "Acme Corp" with email billing@acme.com

✓ Client created: Acme Corp (id: 3f2a...)

> Create an invoice for Acme Corp: 10 hours consulting at $150/hr, 20% tax

✓ Invoice INV-2026-0001 created
  Subtotal: $1,500.00 | Tax: $300.00 | Total: $1,800.00

Evaluar el riesgo de pago

> What's the risk score for invoice INV-2026-0001?

Risk Score: 42/100 (Medium)
  - Invoice Amount: 25 (moderate amount)
  - Client History: 50 (new client)
  - Due Date: 15 (due in 28 days)
  - Reminders: 10 (none sent)
Recommended: Send an early reminder with a polite tone.

Generar informe de flujo de caja

> Show me the cash flow report

April 2026:
  Total Invoiced: $12,400.00
  Collected: $8,200.00 (66.1%)
  Outstanding: $4,200.00
  Overdue: $1,800.00
  Projected (30d): $2,400.00

Monedas soportadas

USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR

Precios

Disponible en el Marketplace de MCPize.

Desarrollo

npm run dev        # Hot reload
npm run build      # Production build
npm test           # Run tests
npm run inspect    # MCP Inspector

Pruebas

Las pruebas cubren la lógica de negocio principal:

• Almacenamiento — Operaciones CRUD, filtrado, números de factura secuenciales

• Modelo de riesgo — Motor de calificación de IA con 4 factores ponderados, clasificación de riesgo

• Flujo de caja — Generación de informes, tasas de cobro, proyecciones, desglose de clientes

npm test           # Run all tests
npx vitest --watch # Watch mode

Licencia Pro

InvoiceFlow se entrega en modo gratuito — invoice_demo_seed, client_manage, invoice_create, invoice_list, invoice_mark_paid y invoice_remind están abiertos. Las siguientes herramientas requieren una licencia Pro:

• invoice_send — generar PDF + envío de correo vía SendGrid

• invoice_risk — predicción de riesgo de pago atrasado

• payment_reconcile — emparejar pagos de Stripe/PayPal/banco con facturas

• cashflow_report — flujo de caja de toda la cartera + proyección a 30 días

Compra una licencia Pro (€12, de por vida, 3 máquinas): https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d

O consigue el Indie MCP Stack Bundle (€69, los 4 servidores).

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

O en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "invoiceflow-mcp": {
      "command": "npx",
      "args": ["-y", "invoiceflow-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

La validación se almacena en caché localmente durante 24 horas; es totalmente capaz de funcionar offline después de la primera ejecución.

Licencia

Licencia MIT. Consulta LICENSE para más detalles.

Creado por Automatia BCN.