Skip to main content
Glama
deenesjakoruzh
softvoyagers

fakturka-api-mcp

by softvoyagers
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Faktuj MCP Server

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

Related MCP server: mcp-ksef-pl

Available Tools

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.

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

Environment Variable

Default

Description

FAKTUJ_API_URL

https://faktuj.pl

Base URL for the Faktuj API

Resources

SoftVoyagers Ecosystem

Faktuj is part of the SoftVoyagers open-source portfolio:

Product

Description

Website

LinkMeta

Free URL metadata extraction API

linkmeta.dev

PageShot

Free screenshot & webpage capture API

pageshot.site

PDFSpark

Free HTML/URL to PDF conversion API

pdfspark.dev

OGForge

Free Open Graph image generator API

ogforge.dev

LinkShrink

Free privacy-first URL shortener API

linkshrink.dev

Faktuj

Free Polish VAT invoice generator

faktuj.pl

QRMint

Free styled QR code generator & API

qrmint.dev

PageDrop

Free instant HTML hosting API

pagedrop.dev

PismoSzyteNaMiarę

Darmowy generator pism urzędowych

pismoszytenamiare.pl

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
F
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • einvoice-mcp

    makririch
    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.
    Last updated
    6
    39
    2
    MIT

  • mcp-ksef-pl

    cmendezs
    A
    license
    A
    quality
    B
    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.
    Last updated
    10
    2
    Apache 2.0

  • @invapi/mcp-server

    invapi-org
    A
    license
    -
    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.
    Last updated
    42
    MIT

View all related MCP servers

Related MCP Connectors

  • Mini Accountant

    Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.

  • fiscal

    Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.

  • scribo

    EN 16931-compliant e-invoices: XRechnung, ZUGFeRD, Factur-X, Peppol BIS, Facturae or US PDF. Free.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/softvoyagers/fakturka-api-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server