fakturka-api-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Faktuj MCP Server
Integrate Faktuj into Claude, Cursor, VS Code, and any MCP-compatible AI assistant. Generate VAT invoices and proforma invoices, look up companies by NIP, check NBP exchange rates, and validate IBAN numbers — all from your AI workflow. Fully aligned with KSeF compliance requirements.
No API key required. Free forever.
Quick Start
Add to your claude_desktop_config.json:
{
"mcpServers": {
"faktuj": {
"command": "npx",
"args": ["-y", "faktuj-mcp"]
}
}
}Or install globally:
npm install -g faktuj-mcpThen add to your config:
{
"mcpServers": {
"faktuj": {
"command": "faktuj-mcp"
}
}
}Related MCP server: mcp-ksef-pl
Available Tools
Tool | Description |
| Generate a Polish VAT invoice PDF. Pass full invoice JSON with seller, buyer, and line items. Returns invoice number and base64 PDF. |
| Generate a proforma invoice PDF. Same schema as VAT invoice. Returns invoice number and base64 PDF. |
| Preview and validate invoice data without generating a PDF. Returns validated data or validation errors. |
| Look up a Polish company by NIP tax identification number. Returns company name, address, and registration data. |
| Look up NBP (National Bank of Poland) exchange rate for a given currency and date. |
| Validate an IBAN number. Returns validation result and bank details if valid. |
Example Usage
Ask your AI assistant:
"Generate a VAT invoice from ACME sp. z o.o. (NIP: 1234567890) to Beta S.A. for 10 hours of consulting at 200 PLN/h"
"Look up the company with NIP 5263442510"
"What was the EUR/PLN exchange rate on 2026-03-20?"
"Validate IBAN PL61109010140000071219812874"
Architecture
AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST APIThis is a thin stdio MCP transport layer over the Faktuj REST API. The MCP server translates tool calls into HTTP requests and returns structured responses.
Configuration
Environment Variable | Default | Description |
|
| Base URL for the Faktuj API |
Resources
VAT Invoice Guide — How to create a compliant Polish VAT invoice
Proforma Invoice Guide — When and how to use proforma invoices
KSeF Compliance — Poland's National e-Invoicing System requirements
Blog — Invoicing guides, tax tips, and product updates
API Documentation — Full REST API reference
SoftVoyagers Ecosystem
Faktuj is part of the SoftVoyagers open-source portfolio:
Product | Description | Website |
LinkMeta | Free URL metadata extraction API | |
PageShot | Free screenshot & webpage capture API | |
PDFSpark | Free HTML/URL to PDF conversion API | |
OGForge | Free Open Graph image generator API | |
LinkShrink | Free privacy-first URL shortener API | |
Faktuj | Free Polish VAT invoice generator | |
QRMint | Free styled QR code generator & API | |
PageDrop | Free instant HTML hosting API | |
PismoSzyteNaMiarę | Darmowy generator pism urzędowych |
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free Polish VAT invoice generator API (Faktura VAT). Generate professional PDF invoices with light/dark themes. No API keys required.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
Free hosted MCP for invoices, estimates, clients, items and PDFs. OAuth authorization required.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.650 npm2MIT
- AlicenseAqualityBmaintenanceModel Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.10263 PyPI3Apache 2.0
- FlicenseBqualityCmaintenanceSingle-tenant MCP server for Polish KSeF e-invoice workflows, supporting local stdio testing, draft management, and invoice submission with safety gates.23-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.40 npmMIT