Ksef PL MCP Server

by cmendezsio.github.cmendezs/mcp-ksef-plv0.10.1

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

3Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active28d ago

Install Ksef PL MCP server

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

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ksef-pl": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-ksef-pl"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
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).

Active — last maintenance signal 28d ago. The newest of the signals below sets the band.

›How do I install the Ksef PL MCP server in Claude Code?

Run: claude mcp add ksef-pl -- uvx mcp-ksef-pl. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ksef PL require an API key?

No required environment variables are declared in its published metadata.

›Can I use Ksef PL as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Ksef PL in the official MCP registry?

Yes, as io.github.cmendezs/mcp-ksef-pl.