Mcp Ksef Pl
Integrate Poland’s KSeF API v2 with FA(3)/FA(2) XML, Peppol BIS 3.0, and NIP/REGON validation through MCP while building Polish billing.
Overview
mcp-ksef-pl is a MCP server for the Build phase that connects agents to Poland’s KSeF API v2 with FA(3)/FA(2) XML, Peppol BIS 3.0, and NIP/REGON validation.
What is this MCP server?
- KSeF API v2 integration with FA(3) and FA(2) XML invoice structures
- Peppol BIS 3.0 interoperability alongside Polish national KSeF flows
- NIP and REGON validation tooling for Polish entity identifiers
- KSEF_ENVIRONMENT production or test (default test) plus challenge/redeem session token auth
- PyPI package mcp-ksef-pl v0.2.2 with configurable KSEF_TIMEOUT (default 30 seconds)
- KSeF API v2 support
- KSEF_TIMEOUT default 30 seconds
- Server version 0.2.2 on PyPI identifier mcp-ksef-pl
Community signal: 1 GitHub stars.
What problem does it solve?
Polish KSeF v2 auth and FA XML submission are tedious for a one-person team building billing without a dedicated tax integration engineer.
Who is it for?
Indie builders adding Poland to invoicing roadmaps who need MCP-driven KSeF v2 and identifier validation during integration.
Skip if: Products with no Polish sales, or merchants who rely entirely on a hosted KSeF portal with no custom agent automation.
What do I get? / Deliverables
Installing the server lets your agent submit and validate Polish e-invoices against test or production KSeF using a session token and structured FA XML tools.
- Agent-driven KSeF v2 invoice submission tooling for FA(3)/FA(2) XML
- NIP and REGON validation results usable in billing onboarding flows
- Test-environment KSeF workflows with optional Peppol BIS 3.0-related operations
Recommended MCP Servers
Journey fit
KSeF and FA structured invoices are integration-heavy Build work for any product invoicing Polish entities after national mandate timelines. Shelved under integrations because the server centers on KSeF v2 auth, submission tools, and identifier validation exposed to your coding agent.
How it compares
Poland KSeF v2 MCP integration, not Italian SDI or Spanish AEAT servers despite shared EU e-invoicing theme.
Common Questions / FAQ
Who is mcp-ksef-pl for?
Developers and solo SaaS builders using AI agents who must integrate Poland’s National e-Invoice System (KSeF) API v2 and FA XML into their stack.
When should I use mcp-ksef-pl?
Use it during Build when implementing submit_invoice_to_ksef, Peppol-related flows, or NIP/REGON checks before production KSeF cutover.
How do I add mcp-ksef-pl to my agent?
Install mcp-ksef-pl from PyPI, configure stdio MCP, complete KSeF challenge/redeem to set KSEF_SESSION_TOKEN and KSEF_NIP, and set KSEF_ENVIRONMENT to test until ready for production.