Fakturka Api

npm version Website API Status

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

Then add to your config:

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

Available Tools

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 API

This 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

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:

License

MIT