InvoiceFlow MCP

KI-gestützte Rechnungsautomatisierung für das Model Context Protocol

👁 License: MIT
👁 TypeScript
👁 MCP

InvoiceFlow erstellt professionelle PDF-Rechnungen, prognostiziert das Risiko verspäteter Zahlungen mittels KI, versendet automatisch Mahnungen, gleicht eingehende Zahlungen mit Rechnungen ab und verfolgt Ihren Cashflow – alles über das MCP-Protokoll.

Funktionen

• Professionelle PDF-Rechnungen mit Positionen, Steuern, Rabatten und mehreren Währungen (10 Währungen)

• KI-Risikoprognose (0-100) basierend auf Rechnungsbetrag, Kundenhistorie, Fälligkeitsdatum und Mahnhistorie

• Intelligente Mahnungen mit Eskalation basierend auf dem Risikoniveau

• Zahlungsabgleich, der eingehende Zahlungen anhand von Betrag + E-Mail-Adresse des Zahlers mit Rechnungen abgleicht (plattformunabhängig – funktioniert mit manuell eingegebenen oder per Webhook bereitgestellten Zahlungsdaten)

• Cashflow-Berichte mit Einzugsquote, prognostiziertem Einkommen und Kundenaufschlüsselung

• Kundenverwaltung mit automatischer Nachverfolgung der Zahlungshistorie

• Fortlaufende Rechnungsnummern (INV-2026-0001, INV-2026-0002, ...)

• 10 MCP-Tools + 4 MCP-Ressourcen, die den gesamten Rechnungslebenszyklus abdecken

Related MCP server: Invoice MCP Server

Schnellstart

Installation über den MCPize Marketplace

1. Suchen Sie auf mcpize.com nach InvoiceFlow MCP

2. Klicken Sie auf Installieren und wählen Sie Ihr Abonnement

3. Tools und Ressourcen sind automatisch in jedem MCP-kompatiblen Client verfügbar

Aus dem Quellcode erstellen

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

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu:

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

Tools

client_manage

Einen neuen Kunden anlegen. Erforderlich vor der Erstellung von Rechnungen.

invoice_create

Eine Rechnung mit Positionen erstellen. Berechnet automatisch Zwischensumme, Steuern, Rabatte und Gesamtbetrag. Generiert fortlaufende Rechnungsnummern (INV-JJJJ-NNNN).

invoice_send

Eine Rechnung als PDF per E-Mail versenden (erfordert SENDGRID_API_KEY). Aktualisiert den Status auf "gesendet".

invoice_list

Rechnungen nach Status, Kunde, Betragsbereich, Datumsbereich oder überfälligem Status filtern. Unterstützt Paginierung.

invoice_mark_paid

Eine Rechnung als bezahlt markieren (vollständig oder teilweise). Aktualisiert automatisch die Zahlungshistorie des Kunden.

invoice_remind

Eine Zahlungserinnerung senden. Erhöht die Mahnanzahl. Unterstützt benutzerdefinierte Nachrichten.

invoice_risk

KI-gestützte Prognose des Risikos verspäteter Zahlungen (0-100). Gibt das Risikoniveau, die Aufschlüsselung der Faktoren, empfohlene Maßnahmen und das Datum der nächsten Mahnung zurück.

cashflow_report

Zusammenfassung des Cashflows generieren: Gesamtsumme in Rechnung gestellt, eingezogen, ausstehend, überfällig, Einzugsquote, 30-Tage-Prognose.

payment_reconcile

Eingehende Zahlung anhand von Betrag und E-Mail-Adresse des Zahlers mit einer Rechnung abgleichen. Markiert die Rechnung automatisch als bezahlt.

Ressourcen

Risikoprognose-Engine

Bewertet Rechnungen von 0-100 unter Verwendung von 4 gewichteten Faktoren:

Risikoniveaus: Niedrig (0-30), Mittel (31-60), Hoch (61-100)

Konfiguration

Kopieren Sie .env.example nach .env und setzen Sie die benötigten Variablen:

cp .env.example .env

SendGrid ist optional. InvoiceFlow funktioniert vollständig offline für Rechnungserstellung, Risikobewertung, Cashflow-Berichte und Abgleich. Fügen Sie SendGrid hinzu, wenn Sie ausgehende E-Mails versenden möchten.

Roadmap: Stripe & PayPal Live-Synchronisierung

Das Tool payment_reconcile gleicht derzeit Beträge ab, die Sie bereitstellen (aus einer CSV, einem Webhook oder manueller Eingabe), mit gespeicherten Rechnungen. Eine direkte Stripe- und PayPal-API-Integration mit Webhook-Listenern ist für v2.0 geplant – siehe Issues für den Fortschritt.

Anwendungsbeispiele

Einen Kunden und eine Rechnung erstellen

> 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

Zahlungsrisiko bewerten

> 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.

Cashflow-Bericht generieren

> 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

Unterstützte Währungen

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

Preise

Verfügbar auf dem MCPize Marketplace.

Entwicklung

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

Tests

Tests decken die Kern-Geschäftslogik ab:

• Speicherung — CRUD-Operationen, Filtern, fortlaufende Rechnungsnummern

• Risikomodell — KI-Bewertungs-Engine mit 4 gewichteten Faktoren, Risikoklassifizierung

• Cashflow — Berichterstellung, Einzugsquoten, Prognosen, Kundenaufschlüsselung

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

Pro-Lizenz

InvoiceFlow wird im Kostenlos-Modus ausgeliefert — invoice_demo_seed, client_manage, invoice_create, invoice_list, invoice_mark_paid und invoice_remind sind offen. Die folgenden Tools erfordern eine Pro-Lizenz:

• invoice_send — PDF-Generierung + SendGrid E-Mail-Versand

• invoice_risk — Prognose des Risikos verspäteter Zahlungen

• payment_reconcile — Abgleich von Stripe/PayPal/Bank-Zahlungen mit Rechnungen

• cashflow_report — Portfolio-weiter Cashflow + 30-Tage-Prognose

Kaufen Sie eine Pro-Lizenz (12 €, lebenslang, 3 Rechner): https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d

Oder holen Sie sich das Indie MCP Stack Bundle (69 €, alle 4 Server).

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

Oder in Ihrer MCP-Client-Konfiguration:

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

Die Validierung wird lokal für 24 Stunden zwischengespeichert – nach dem ersten Ausführen vollständig offline-fähig.

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.

Entwickelt von Automatia BCN.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• cashflow_reportA
• client_manageA
• invoice_createA
• invoice_demo_seedA
• invoice_listA
• invoice_mark_paidA
• invoice_remindA
• invoice_riskA