Ksef Pl MCP Server

A Python MCP server providing tools for Polish electronic invoicing compliant with KSeF (FA(2)) and Peppol BIS Billing 3.0 / EN 16931. It enables AI agents (Claude, IDEs) to generate, validate, and submit invoices to the Krajowy System e-Faktur (KSeF), as well as validate Polish tax identifiers (NIP and REGON). Its 21 documented tools cover invoice, validate, peppol, generate.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 2 · #83 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install Ksef Pl

before you install - you'll need

Set KSEF_ENVIRONMENT, KSEF_SESSION_TOKEN, KSEF_NIP before connecting.

Claude Code

claude mcp add cmendezs-mcp-ksef-pl -- uvx mcp-ksef-pl

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cmendezs-mcp-ksef-pl": {
      "command": "uvx",
      "args": [
        "mcp-ksef-pl"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

pypi package mcp-ksef-pl - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.cmendezs is GitHub-verified and matches the repo owner

03 · What Ksef Pl can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can generate a KSeF-compliant FA(3) XML invoice (required for KSeF API v2 submissions), generate a KSeF-compliant FA(2) XML invoice (legacy format, read-only use), retrieve the processing status of an invoice by its reference number, and search invoices in KSeF by date range and direction (seller/buyer).

Capability map

Tools grouped from the project's README - what Ksef Pl lets an agent do.

Validate

8 tools - e.g. Validates FA(3) XML: XSD validation and FA(3)-specific business rules; Validates FA(2) XML: XSD validation (if the schema is available) and business rules; Validates a NIP (10-digit tax identification…

validate_fa3_invoice · validate_fa2_invoice · validate_polish_nip · validate_polish_regon · validate_peppol_invoice · validate_eusr_report…

Peppol

5 tools - e.g. Check whether a business is registered on the Peppol network; returns registration status and supported document types; Fetch the AS4 endpoint for a participant's document type; DNS-only (SML) diagnostic…

peppol_lookup_participant · peppol_get_service_endpoint · resolve_peppol_dns · peppol_send · peppol_directory_search

Generate

3 tools - e.g. Generates a KSeF-compliant FA(3) XML invoice (required for KSeF API v2 submissions); Generates a KSeF-compliant FA(2) XML invoice (legacy format, read-only use); Generates a UBL 2.1 invoice compliant with…

generate_fa3_invoice · generate_fa2_invoice · generate_peppol_invoice

Ksef

3 tools - e.g. Submits an FA(3) invoice to the KSeF platform and returns a reference number; Retrieves the processing status of an invoice by its reference number; Searches invoices in KSeF by date range and direction…

submit_invoice_to_ksef · get_ksef_invoice_status · search_ksef_invoices

Parse

1 tool - e.g. Parses FA(2) XML into a structured dictionary

parse_fa2_invoice

Build

1 tool - e.g. Build a document-level MLS response. Requires the [xslt2] extra.

build_mls_message

Latest releases

v0.8.2 · 2026-08-24

v0.8.1 · 2026-08-24

v0.8.0 · 2026-08-24

04 · Who maintains Ksef Pl

mcp-ksef-pl is maintained by cmendezs. We track 8 MCP servers from cmendezs - 8 actively maintained, 6 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from cmendezs.

mcp-facturacion-electronica-es Spanish e-invoicing MCP server: VERI*FACTU, Facturae/FACe, SII, Crea y Crece B2B. ★ 2

05 · Facts

repository: github.com/cmendezs/mcp-ksef-pl
category: API integration - ranked #83 of 250 actively-maintained API integration servers as of 2026-08-25.
release cadence: 9 releases in the last 90 days (latest 2026-08-24)
registry: io.github.cmendezs/mcp-ksef-pl (active, first published 2026-05-06 · 11 versions)
packages: pypi:mcp-ksef-pl

06 · Ksef Pl FAQ

Is Ksef Pl still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 9 releases in the last 90 days. We re-verify nightly.

What can Ksef Pl do?

How do I install Ksef Pl?

Run `uvx mcp-ksef-pl`. The README documents 3 environment variables (KSEF_ENVIRONMENT, KSEF_SESSION_TOKEN, KSEF_NIP) to set first. Set KSEF_ENVIRONMENT, KSEF_SESSION_TOKEN, KSEF_NIP before connecting. You can also paste the ready-made client config above.

Does Ksef Pl run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ksef Pl

Alternatives to Ksef Pl

Maintained API integration servers if Ksef Pl isn't the fit.

More API integration MCP servers · API Testing MCP · Shopee · Braintree · Pix Bcb · Portkey Admin MCP

More Python MCP servers · Ethical Hacking · Tick MCP · Codealive MCP · Codelogic MCP Server · Kiln · see all