PluginBench
MCP Server
Active
Apache-2.0

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

io.github.cmendezs/mcp-ksef-pl

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).

Claude Desktop
~/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>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.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>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "mcp-ksef-pl": {
      "type": "stdio",
      "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>"
      }
    }
  }
}
Claude Code
claude mcp add mcp-ksef-pl --env KSEF_SESSION_TOKEN=<YOUR_KSEF_SESSION_TOKEN> --env KSEF_NIP=<YOUR_KSEF_NIP> --env KSEF_ENVIRONMENT=<YOUR_KSEF_ENVIRONMENT> --env KSEF_TIMEOUT=<YOUR_KSEF_TIMEOUT> -- uvx mcp-ksef-pl

Related MCP servers

German e-invoicing MCP server: ZUGFeRD 2.x, XRechnung 3.x, EN 16931, KoSIT validation, Peppol.

1
XSLT
Apache-2.0
View repository →

Spanish e-invoicing MCP server: VERI*FACTU, Facturae/FACe, SII, Crea y Crece B2B.

1
XSLT
Apache-2.0
View repository →

Belgian e-invoicing MCP server: Peppol BIS 3.0, UBL 2.1, EU PINT v1.0.1, Mercurius.

0
Python
Apache-2.0
View repository →

Base package for European e-invoicing MCP servers with shared models, XML utils, and OAuth2 client.

0
Python
Apache-2.0
View repository →

MCP server for French e-invoicing (XP Z12-013). Manages invoices, validation and compliance.

0
XSLT
Apache-2.0
View repository →

Italian e-invoicing: FatturaPA XML/SDI v1.2.3, 42 tools. Signing, SDI, archiving.

0
Python
Apache-2.0
View repository →