Ksef Pl MCP server
Polish e-invoicing MCP: KSeF API v2, FA(3)/FA(2) XML, Peppol BIS 3.0, NIP/REGON validation.
3 stars91 downloads/wk
Reviews
Write oneNobody has reviewed Ksef Pl yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ksef Pl tools (1, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
run_check_3write actionCHECK 3 — Core model field availability (InvoiceDocument field coverage).
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan23 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Ksef Pl compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 93% of 48,243 servers
- Tools
- 1
- the typical server has 7
- Tools that change things
- 100%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 80% of 28,706 servers
- Downloads a week
- 91
- more than 60% of 12,306 servers with a package
What its tools let an agent do: 1 run or deploy
Install Ksef Pl in Claude Code, Cursor or VS Code
claude mcp add mcp-ksef-pl -- uvx mcp-ksef-pl
What the publisher says
From the Ksef Pl repository's README, as published. We do not edit it. Read it on GitHub
mcp-ksef-pl 🇵🇱
English | Polski
<!-- mcp-name: io.github.cmendezs/mcp-ksef-pl -->
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).
Introduction
This package is built on mcp-einvoicing-core, the shared base library for European e-invoicing MCP servers. It provides an OAuth2 HTTP client, token cache, data models, logging utilities, and an exception hierarchy.
mcp-einvoicing-core is installed automatically as a dependency, no additional step is required.
Installation
Via PyPI (recommended)
pip install mcp-ksef-plOr without prior installation using uvx:
uvx mcp-ksef-plFrom source
git clone https://github.com/cmendezs/mcp-ksef-pl.git
cd mcp-ksef-pl
uv sync --all-extrasConfiguration (environment variables)
The EUSR/TSR reporting and MLS tools additionally require the [xslt2] extra (pip install "mcp-ksef-pl[xslt2]") for Schematron validation.
Claude Desktop integration
Add the following configuration to your claudedesktopconfig.json file:
{
"mcpServers": {
"ksef-pl": {
"command": "uvx",
"args": ["mcp-ksef-pl"],
"env": {
"KSEF_ENVIRONMENT": "test",
"KSEF_SESSION_TOKEN": "<your-ksef-session-token>",
"KSEF_NIP": "<your-nip>"
}
}
}
}Cursor integration
Cursor supports MCP servers via stdio. Add the configuration to:
- Globally (all projects): ~/.cursor/mcp.json
- Per project (this repository only): .cursor/mcp.json
{
"mcpServers": {
"ksef-pl": {
"command": "uvx",
"args": ["mcp-ksef-pl"],
"env": {
"KSEF_ENVIRONMENT": "test",
"KSEF_SESSION_TOKEN": "<your-ksef-session-token>",
"KSEF_NIP": "<your-nip>"
}
}
}
}Reload the Cursor window (Ctrl+Shift+P → Reload Window) after saving changes.
Kiro integration
Kiro supports MCP servers through a dedicated configuration file:
- Globally: ~/.kiro/settings/mcp.json
- Workspace: .kiro/settings/mcp.json
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ksef Pl: common questions
- Is Ksef Pl MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Ksef Pl safety report
- How do I install Ksef Pl?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ksef Pl need an API key?
- No secret keys are declared. It reads 4 settings from the environment.
- Is Ksef Pl maintained?
- The last commit was 54 days ago (2026-09-12). The latest release is v0.10.1.
- How does Ksef Pl compare with other MCP servers?
- safety score 92/100 (higher than 93% of 48,243 servers); tools 1 (the typical server has 7); tools that change things 100% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.