io.github.cmendezs/mcp-ksef-pl MCP Server

io.github.cmendezs/mcp-ksef-pl

Repository Registry

What is the io.github.cmendezs/mcp-ksef-pl MCP server?

Polish e-invoicing MCP: KSeF API v2, FA(3)/FA(2) XML, Peppol BIS 3.0, NIP/REGON validation.

How to install io.github.cmendezs/mcp-ksef-pl

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

KSEF_SESSION_TOKEN
KSeF v2 AccessToken obtained via the challenge/redeem auth flow. Required for submit_invoice_to_ksef.
KSEF_NIP
NIP (Polish tax identifier, 10 digits) of the entity submitting invoices.
KSEF_ENVIRONMENT
Target KSeF environment: 'production' or 'test' (default: test).
KSEF_TIMEOUT
HTTP request timeout in seconds (default: 30).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ksef-pl": {
      "command": "uvx",
      "args": [
        "mcp-ksef-pl"
      ],
      "env": {
        "KSEF_SESSION_TOKEN": "<YOUR_KSEF_SESSION_TOKEN>",
        "KSEF_NIP": "<YOUR_KSEF_NIP>",
        "KSEF_ENVIRONMENT": "<YOUR_KSEF_ENVIRONMENT>",
        "KSEF_TIMEOUT": "<YOUR_KSEF_TIMEOUT>"
      }
    }
  }
}