fakturka-api-mcp

[](https://www.npmjs.com/package/faktuj-mcp) [](https://faktuj.pl) [](https://faktuj.pl/health)

Integrate [Faktuj](https://faktuj.pl) into Claude, Cursor, VS Code, and any MCP-compatible AI assistant. Generate Polish VAT invoices, proforma invoices, look up companies by NIP, check NBP exchange rates, and validate IBAN numbers — all from your AI workflow.

No API key required. Free forever.

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"
    }
  }
}

| Tool | Description | |------|-------------| | generate_invoice | Generate a Polish VAT invoice PDF. Pass full invoice JSON with seller, buyer, and line items. Returns invoice number and base64 PDF. | | generate_proforma | Generate a proforma invoice PDF. Same schema as VAT invoice. Returns invoice number and base64 PDF. | | preview_invoice | Preview and validate invoice data without generating a PDF. Returns validated data or validation errors. | | lookup_nip | Look up a Polish company by NIP tax identification number. Returns company name, address, and registration data. | | lookup_nbp_rate | Look up NBP (National Bank of Poland) exchange rate for a given currency and date. | | validate_iban | Validate an IBAN number. Returns validation result and bank details if valid. |

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 t