Skip to main content
Glama
softvoyagers

fakturka-api-mcp

by softvoyagers

Faktuj MCP-Server

npm version Website API Status

Integrieren Sie Faktuj in Claude, Cursor, VS Code und jeden anderen MCP-kompatiblen KI-Assistenten. Erstellen Sie Mehrwertsteuerrechnungen und Proformarechnungen, suchen Sie Unternehmen anhand der NIP-Nummer, prüfen Sie NBP-Wechselkurse und validieren Sie IBAN-Nummern – alles direkt aus Ihrem KI-Workflow. Vollständig konform mit den Anforderungen des KSeF.

Kein API-Schlüssel erforderlich. Für immer kostenlos.

Schnelleinstieg

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "faktuj": {
      "command": "npx",
      "args": ["-y", "faktuj-mcp"]
    }
  }
}

Oder installieren Sie es global:

npm install -g faktuj-mcp

Fügen Sie es dann zu Ihrer Konfiguration hinzu:

{
  "mcpServers": {
    "faktuj": {
      "command": "faktuj-mcp"
    }
  }
}

Related MCP server: mcp-ksef-pl

Verfügbare Tools

Tool

Beschreibung

generate_invoice

Erstellt eine polnische Mehrwertsteuerrechnung als PDF. Übergeben Sie das vollständige Rechnungs-JSON mit Verkäufer, Käufer und Rechnungspositionen. Gibt die Rechnungsnummer und das base64-PDF zurück.

generate_proforma

Erstellt eine Proformarechnung als PDF. Gleiches Schema wie bei der Mehrwertsteuerrechnung. Gibt die Rechnungsnummer und das base64-PDF zurück.

preview_invoice

Vorschau und Validierung von Rechnungsdaten ohne PDF-Erstellung. Gibt validierte Daten oder Validierungsfehler zurück.

lookup_nip

Suche nach einem polnischen Unternehmen anhand der NIP-Steuernummer. Gibt Firmenname, Adresse und Registrierungsdaten zurück.

lookup_nbp_rate

Suche nach dem NBP-Wechselkurs (Polnische Nationalbank) für eine bestimmte Währung und ein bestimmtes Datum.

validate_iban

Validierung einer IBAN-Nummer. Gibt das Validierungsergebnis und bei Gültigkeit die Bankdaten zurück.

Anwendungsbeispiele

Fragen Sie Ihren KI-Assistenten:

  • "Erstelle eine Mehrwertsteuerrechnung von ACME sp. z o.o. (NIP: 1234567890) an Beta S.A. für 10 Stunden Beratung zu 200 PLN/h"

  • "Suche nach dem Unternehmen mit der NIP 5263442510"

  • "Wie war der EUR/PLN-Wechselkurs am 20.03.2026?"

  • "Validiere die IBAN PL61109010140000071219812874"

Architektur

AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API

Dies ist eine schlanke stdio-MCP-Transportschicht über der Faktuj REST API. Der MCP-Server übersetzt Tool-Aufrufe in HTTP-Anfragen und gibt strukturierte Antworten zurück.

Konfiguration

Umgebungsvariable

Standardwert

Beschreibung

FAKTUJ_API_URL

https://faktuj.pl

Basis-URL für die Faktuj-API

Ressourcen

SoftVoyagers-Ökosystem

Faktuj ist Teil des Open-Source-Portfolios von SoftVoyagers:

Produkt

Beschreibung

Website

LinkMeta

Kostenlose API zur Extraktion von URL-Metadaten

linkmeta.dev

PageShot

Kostenlose API für Screenshots & Webseiten-Erfassung

pageshot.site

PDFSpark

Kostenlose API zur HTML/URL-zu-PDF-Konvertierung

pdfspark.dev

OGForge

Kostenlose API für Open-Graph-Bildgenerierung

ogforge.dev

LinkShrink

Kostenlose, datenschutzfreundliche URL-Kürzer-API

linkshrink.dev

Faktuj

Kostenloser polnischer Mehrwertsteuerrechnungs-Generator

faktuj.pl

QRMint

Kostenloser Generator für gestylte QR-Codes & API

qrmint.dev

PageDrop

Kostenlose API für sofortiges HTML-Hosting

pagedrop.dev

PismoSzyteNaMiarę

Darmowy generator pism urzędowych

pismoszytenamiare.pl

Lizenz

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.
    6
    45 npm
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Model Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.
    10
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.
    48 npm
    MIT