io.github.cmendezs/mcp-ksef-pl
PYPI · MCP-KSEF-PL · SCANNED SEP 20
Polish e-invoicing MCP: KSeF API v2, FA(3)/FA(2) XML, Peppol BIS 3.0, NIP/REGON validation.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- 2 of 29 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 7 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability74
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 4570 tokens (~81/item across 56 items; 56 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage89
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 62% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "peppol_send" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 57 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.cmendezs/mcp-ksef-pl server?
io.github.cmendezs/mcp-ksef-pl runs locally as a PyPI package, launched with uvx mcp-ksef-pl. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mcp-ksef-pl
claude mcp add cmendezs-mcp-ksef-pl -- uvx mcp-ksef-pl
{
"mcpServers": {
"cmendezs-mcp-ksef-pl": {
"command": "uvx",
"args": [
"mcp-ksef-pl"
]
}
}
} {
"servers": {
"cmendezs-mcp-ksef-pl": {
"command": "uvx",
"args": [
"mcp-ksef-pl"
]
}
}
} codex mcp add cmendezs-mcp-ksef-pl -- uvx mcp-ksef-pl
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cmendezs-mcp-ksef-pl": {
"type": "local",
"command": [
"uvx",
"mcp-ksef-pl"
],
"enabled": true
}
}
} openclaw mcp add cmendezs-mcp-ksef-pl --command uvx --arg mcp-ksef-pl
mcp_servers:
cmendezs-mcp-ksef-pl:
command: "uvx"
args: ["mcp-ksef-pl"] {
"McpServers": {
"cmendezs-mcp-ksef-pl": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mcp-ksef-pl"
]
}
}
} assistant mcp add cmendezs-mcp-ksef-pl -t stdio -c uvx -a mcp-ksef-pl
{
"mcpServers": {
"cmendezs-mcp-ksef-pl": {
"command": "uvx",
"args": [
"mcp-ksef-pl"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
- Stability: 0.97 → pass security
- Security disclosure: pass → unverified ▼ functional
- 18 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 17 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 15 Sept 26 +16
- Malware scan: unverified → pass ▲ security
- 14 Sept 26 −18
- Malware scan: pass → unverified ▼ security
- Stability: pass → 0.83 functional
- 13 Sept 26 +1
- Stability: 0.97 → pass security
- 12 Sept 26 +14
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Stability: pass → 0.97 functional
- Package version: 0.10.0 → 0.10.1 functional
- 11 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/mcp-ksef-pl@0.10.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 29 packages
| Packages resolved | 29 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
build_mls_message Build Mls Message ~291
Build a document-level MLS response and return it base64-encoded. For per-line responses, build the document directly with `mcp_einvoicing_core.peppol.mls.build_mls`.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Optional human-readable response text. |
| document_reference_id | string | yes | The SBDH ``InstanceIdentifier`` of the source message this MLS reports on. |
| issue_date | string | yes | ISO date string, e.g. "2026-08-23". |
| issue_time | string | – | Optional ISO time string, e.g. "12:00:00Z". |
| mls_id | string | yes | The ``cbc:ID`` of this MLS document. |
| receiver_scheme_id | string | yes | ICD scheme of the receiving endpoint (normally the original message's SBDH ``MLS_TO`` scheme). |
| receiver_value | string | yes | Receiving endpoint value. |
| response_code | string | yes | "AB" (Acknowledged), "AP" (Accepted), or "RE" (Rejected). |
| sender_scheme_id | string | yes | ICD scheme of the sending Access Point's endpoint. |
| sender_value | string | yes | Sending Access Point's endpoint value. |
| status_reason_code | string | – | Optional: "SV", "BV", "BW", or "FD" (required by the Schematron when response_code is "RE"). |
Structured output declared, but exposes no named fields.
No examples provided.
check_allowance_reason_code Check Allowance Reason Code ~30
Check whether *code* is a recognized allowance reason code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_charge_reason_code Check Charge Reason Code ~29
Check whether *code* is a recognized charge reason code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_country_code Check Country Code ~36
Check whether *code* is a recognized ISO 3166-1 alpha-2 country code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_currency_code Check Currency Code ~31
Check whether *code* is a recognized ISO 4217 currency code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_document_name_code Check Document Name Code ~33
Check whether *code* is a recognized UNCL1001 document name code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_document_type_id_in_codelist Check Document Type Id In Codelist ~95
Check whether a (scheme, value) pair is a recognized Peppol document type identifier. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`). Searches all entries regardless of state, so a historical (deprecated or removed) document type is still reported as found.
| Name | Type | Req | Description |
|---|---|---|---|
| scheme | string | yes | – |
| value | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_eas_code Check Eas Code ~30
Check whether *code* is a recognized Electronic Address Scheme code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_icd_code Check Icd Code ~32
Check whether *code* is a recognized ISO 6523 ICD code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_item_type_code Check Item Type Code ~30
Check whether *code* is a recognized item type identification code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_mime_code Check Mime Code ~31
Check whether *code* is a recognized MIME type for embedded attachments.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_participant_id_scheme_in_codelist Check Participant Id Scheme In Codelist ~74
Check whether a 4-digit ISO 6523 ICD code (e.g. "0208") is a recognized Peppol scheme. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`).
| Name | Type | Req | Description |
|---|---|---|---|
| icd | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_payment_means_code Check Payment Means Code ~34
Check whether *code* is a recognized UNCL4461 payment means code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_process_id_in_codelist Check Process Id In Codelist ~68
Check whether a (scheme, value) pair is a recognized Peppol process identifier. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`).
| Name | Type | Req | Description |
|---|---|---|---|
| scheme | string | yes | – |
| value | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_reference_qualifier_code Check Reference Qualifier Code ~35
Check whether *code* is a recognized UNCL1153 reference qualifier code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_vat_category_code Check Vat Category Code ~34
Check whether *code* is a recognized UNCL5305 VAT category code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
check_vatex_code Check Vatex Code ~32
Check whether *code* is a recognized VATEX VAT exemption reason code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
generate_fa2_invoice Generate Fa2 Invoice ~180
Generate a KSeF-compliant FA(2) XML invoice from structured invoice data. Returns the FA(2) XML string ready for submission to KSeF. The seller's nip must be a Polish NIP (10 digits).
| Name | Type | Req | Description |
|---|---|---|---|
| invoice | object | yes | EN 16931 invoice extended for KSeF FA(2)/FA(3) submission. National extensions: numer_ksef — KSeF reference number, assigned by the platform post-clearance. Not present on the out… |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
generate_fa3_invoice Generate Fa3 Invoice ~373
Generate a KSeF-compliant FA(3) XML invoice from structured invoice data. FA(3) is required for all new invoice submissions via KSeF API v2. Use this tool, not generate_fa2_invoice, before calling submit_invoice_to_ksef. The seller's nip must be a Polish NIP (10 digits). The buyer's nip may be a Polish NIP, eu_vat_country/eu_vat_id for EU cross-border, or neither (emits <BrakID>). Use the optional `options` parameter to supply: - IPKSeF / LinkDoPlatnosci payment identifiers (PL-2.2) - Correction invoice reference (rodzaj_faktury=KOR + correction block) (PL-4.1) - Supporting document attachments (<Zalacznik>) (PL-2.3) - Additional buyer entities (<Podmiot3>) (PL-2.4) - Authorised representative (<PodmiotUpowazniony>) (PL-2.4) Returns the FA(3) XML string ready for submit_invoice_to_ksef.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice | object | yes | EN 16931 invoice extended for KSeF FA(2)/FA(3) submission. National extensions: numer_ksef — KSeF reference number, assigned by the platform post-clearance. Not present on the out… |
| options | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
generate_peppol_invoice Generate Peppol Invoice ~188
Generate a Peppol BIS Billing 3.0 / EN 16931 UBL 2.1 XML invoice. Use this for cross-border B2B invoicing via the Peppol network. For domestic Polish invoicing, use generate_fa3_invoice instead.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice | object | yes | EN 16931 invoice extended for KSeF FA(2)/FA(3) submission. National extensions: numer_ksef — KSeF reference number, assigned by the platform post-clearance. Not present on the out… |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
get_en16931_codelist_version Get En16931 Codelist Version ~32
Report the CEF EN 16931 code-list release version(s) currently configured locally.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
get_ksef_invoice_status Get Ksef Invoice Status ~60
Retrieve the processing status of a submitted KSeF invoice (API v2).
| Name | Type | Req | Description |
|---|---|---|---|
| reference_number | string | yes | ("{sessionRef}:{invoiceRef}"). Pass just the sessionRef to retrieve the overall session status instead. |
Structured output declared, but exposes no named fields.
No examples provided.
get_peppol_codelist_version Get Peppol Codelist Version ~32
Report the OpenPeppol eDEC code list release version(s) currently configured locally.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_allowance_reason_codes List Allowance Reason Codes ~26
List allowance reason codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_charge_reason_codes List Charge Reason Codes ~25
List charge reason codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_country_codes List Country Codes ~32
List ISO 3166-1 alpha-2 country codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_currency_codes List Currency Codes ~27
List ISO 4217 currency codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_document_name_codes List Document Name Codes ~29
List UNCL1001 document name codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_document_type_ids List Document Type Ids ~69
List Peppol document type identifiers from the OpenPeppol eDEC code list. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`).
| Name | Type | Req | Description |
|---|---|---|---|
| active_only | boolean | – | When True (default), omit deprecated/removed entries. |
Structured output declared, but exposes no named fields.
No examples provided.
list_eas_codes List Eas Codes ~30
List Electronic Address Scheme (EAS) codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_icd_codes List Icd Codes ~28
List ISO 6523 ICD codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_item_type_codes List Item Type Codes ~26
List item type identification codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_mime_codes List Mime Codes ~18
List recognized MIME types for embedded attachments.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_participant_id_schemes List Participant Id Schemes ~120
List Peppol participant identifier (ICD) schemes from the OpenPeppol eDEC code list. Requires EINVOICING_PEPPOL_CODELIST_DIR to point at a local copy of the eDEC "Participant Identifier Schemes" GeneriCode export (not bundled with this package, no confirmed redistribution rights, see `mcp_einvoicing_core.peppol.codelists` module docstring).
| Name | Type | Req | Description |
|---|---|---|---|
| active_only | boolean | – | When True (default), omit deprecated/removed entries. |
Structured output declared, but exposes no named fields.
No examples provided.
list_payment_means_codes List Payment Means Codes ~30
List UNCL4461 payment means codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_process_ids List Process Ids ~67
List Peppol process identifiers from the OpenPeppol eDEC code list. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`).
| Name | Type | Req | Description |
|---|---|---|---|
| active_only | boolean | – | When True (default), omit deprecated/removed entries. |
Structured output declared, but exposes no named fields.
No examples provided.
list_reference_qualifier_codes List Reference Qualifier Codes ~31
List UNCL1153 reference qualifier codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_spis_use_case_ids List Spis Use Case Ids ~73
List Peppol SPIS use case identifiers from the OpenPeppol eDEC code list. Requires EINVOICING_PEPPOL_CODELIST_DIR (see `list_participant_id_schemes`).
| Name | Type | Req | Description |
|---|---|---|---|
| active_only | boolean | – | When True (default), omit deprecated/removed entries. |
Structured output declared, but exposes no named fields.
No examples provided.
list_vat_category_codes List Vat Category Codes ~30
List UNCL5305 VAT category codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
list_vatex_codes List Vatex Codes ~30
List VATEX (VAT exemption reason) codes from the CEF EN 16931 code list.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
parse_fa2_invoice Parse Fa2 Invoice ~58
Parse a KSeF FA(2) XML invoice into a structured dictionary. Returns a nested dict with 'header', 'seller', 'buyer', 'invoice', and 'lines' keys.
| Name | Type | Req | Description |
|---|---|---|---|
| xml_content | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
peppol_directory_search Peppol Directory Search ~188
Search the Peppol Directory for registered participants. Public, unauthenticated search (no relation to SMP lookup). At least one of q/participant/name/country/doctype must be supplied.
| Name | Type | Req | Description |
|---|---|---|---|
| country | – | – | Exact match on ISO 3166-2 country code. |
| doctype | – | – | Exact match on a full document type identifier URN. |
| environment | string | – | "production" or "test". |
| name | – | – | Partial match on business entity name (min. 3 characters). |
| participant | – | – | Exact match on a scheme-qualified participant ID (e.g. "iso6523-actorid-upis::0208:0123456789"). |
| q | – | – | General purpose query term, matched across all fields. |
| result_page_count | integer | – | Results per page. |
| result_page_index | integer | – | 0-based result page index. |
Structured output declared, but exposes no named fields.
No examples provided.
peppol_get_service_endpoint Peppol Get Service Endpoint ~153
Fetch the AS4 endpoint for a Peppol participant's document type. Resolves the SMP hostname via DNS, then fetches service metadata for *document_type_id*. If the SMP returns a redirect, the result's `redirect_url` is set and `endpoint_url` is None; callers must not follow more than one redirect hop (SMP 1.4.0 §3.2).
| Name | Type | Req | Description |
|---|---|---|---|
| document_type_id | string | – | Peppol document type identifier URN (default: BIS Billing 3.0 invoice). |
| environment | string | – | "production" or "test". |
| identifier | string | yes | Peppol participant ID or adaptable national identifier. |
Structured output declared, but exposes no named fields.
No examples provided.
peppol_lookup_participant Peppol Lookup Participant ~120
Check whether a business is registered on the Peppol network. Performs a DNS-over-HTTPS U-NAPTR lookup followed by an SMP service-group request to determine registration status and the list of supported document type identifiers.
| Name | Type | Req | Description |
|---|---|---|---|
| environment | string | – | "production" or "test". |
| identifier | string | yes | Peppol participant ID ("<scheme>:<value>") or a bare national identifier this server knows how to adapt (e.g. a VAT number, if a national identifier adapter is configured). |
Structured output declared, but exposes no named fields.
No examples provided.
peppol_send Peppol Send ~208
Send a UBL/CII invoice to a Peppol participant via AS4. Looks up the recipient's AS4 endpoint (SMP), builds the ebMS3/AS4 envelope, and transmits it using the supplied signing credentials.
| Name | Type | Req | Description |
|---|---|---|---|
| certificate_path | string | yes | Path to the PEM-encoded signing certificate. |
| document_type_id | string | – | Peppol document type identifier URN (default: BIS Billing 3.0 invoice). |
| environment | string | – | "production" or "test". |
| invoice_xml_base64 | string | yes | Base64-encoded UBL or CII invoice XML. |
| private_key_password | string | – | Optional password for the private key. |
| private_key_path | string | yes | Path to the PEM-encoded private key. |
| recipient_identifier | string | yes | Peppol participant ID or adaptable national identifier of the receiver. |
| sender_id | string | yes | Peppol AP identifier of the sender. |
Structured output declared, but exposes no named fields.
No examples provided.
resolve_peppol_dns Resolve Peppol Dns ~94
Resolve the SMP hostname for a Peppol participant via DNS only. Performs the raw U-NAPTR (SML) lookup without fetching the SMP service group, useful for diagnosing whether a participant is registered in the SML independently of SMP reachability.
| Name | Type | Req | Description |
|---|---|---|---|
| environment | string | – | "production" or "test". |
| identifier | string | yes | Peppol participant ID or adaptable national identifier. |
Structured output declared, but exposes no named fields.
No examples provided.
search_ksef_invoices Search Ksef Invoices ~76
Query invoices stored in KSeF for a date range.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | yes | – |
| date_to | string | yes | – |
| subject_type | string | – | or 'SubjectAuthorized' (authorised representative). Case-insensitive; normalized to the KSeF v2 PascalCase enum before submission. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
submit_invoice_to_ksef Submit Invoice To Ksef ~204
Submit a FA(3) XML invoice to the KSeF platform (API v2). KSeF API v2 requires FA(3) format for submission. Use generate_fa3_invoice to produce FA(3) XML before calling this tool. HUMAN-IN-THE-LOOP: Call without confirmation_token first to receive a confirmation summary and token. Show the summary to the user, then call again with confirmation_token set to execute the actual submission.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmation_token | string | – | – |
| session_token | string | – | Obtain via the challenge → authenticate → redeem flow: https://github.com/CIRFMF/ksef-docs/blob/main/uwierzytelnianie.md |
| session_token_expires_at | string | – | A warning is logged if fewer than 60 seconds remain; submission is blocked if the token is already expired. |
| xml_content | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
validate_eusr_report Validate Eusr Report ~69
Validate a Peppol End User Statistics Report (EUSR) document. Runs XSD structural validation, then Schematron business rules (requires the ``[xslt2]`` optional extra).
| Name | Type | Req | Description |
|---|---|---|---|
| report_xml_base64 | string | yes | Base64-encoded EUSR XML document. |
Structured output declared, but exposes no named fields.
No examples provided.
validate_fa2_invoice Validate Fa2 Invoice ~61
Validate a KSeF FA(2) XML invoice. Runs XSD validation (when the official schema is present) and Polish business-rule checks. Returns a DocumentValidationResult with errors and warnings.
| Name | Type | Req | Description |
|---|---|---|---|
| xml_content | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| errors | array | – | – |
| metadata | object | – | – |
| valid | boolean | yes | – |
| warnings | array | – | – |
No examples provided.
What is the io.github.cmendezs/mcp-ksef-pl server?
io.github.cmendezs/mcp-ksef-pl is listed in the public MCP registry as io.github.cmendezs/mcp-ksef-pl. Polish e-invoicing MCP: KSeF API v2, FA(3)/FA(2) XML, Peppol BIS 3.0, NIP/REGON validation. This page covers its PyPI package (mcp-ksef-pl).
Is the io.github.cmendezs/mcp-ksef-pl server safe to use?
io.github.cmendezs/mcp-ksef-pl scores 83 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cmendezs/mcp-ksef-pl server expose?
io.github.cmendezs/mcp-ksef-pl exposes 56 tools: generate_fa2_invoice, generate_fa3_invoice, validate_fa2_invoice, validate_fa3_invoice, parse_fa2_invoice, and 51 more. Their descriptions and schemas cost roughly 4,347 tokens of context every time the server is loaded.
Is the io.github.cmendezs/mcp-ksef-pl server still maintained?
io.github.cmendezs/mcp-ksef-pl is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.cmendezs/mcp-ksef-pl server under?
io.github.cmendezs/mcp-ksef-pl declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.