Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KSEF_NIPNoYour NIP (Polish tax ID) for KSeF.
KSEF_TOKENNoKSeF API token for token-based authentication.
KSEF_CERT_PATHNoPath to PKCS#12 certificate file for certificate-based authentication.
KSEF_CERT_PASSWORDNoPassword for the certificate file (if encrypted).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
ksef_session_statusA

Report configured KSeF environment and auth state without exposing secrets.

ksef_test_connection_checkC

Authenticate to KSeF TEST and persist readiness before invoice XML generation.

ksef_get_capabilitiesA

Report supported, advisory, unsupported, and manual-smoke workflow capabilities.

ksef_list_invoicesB

Query KSeF invoice metadata for a date range and role.

ksef_get_invoiceB

Fetch a KSeF invoice by reference number.

ksef_download_upoC

Retrieve invoice or session UPO for a known KSeF session.

ksef_check_attachment_permissionA

Check whether the current KSeF context may issue invoices with FA(3) attachments.

ksef_validate_nipA

Validate a Polish NIP checksum.

ksef_validate_fa3_xmlB

Validate FA(3) XML against the vendored official XSD.

ksef_lookup_counterpartyB

Look up advisory counterparty data from MF, VIES, KRS, or GUS sources.

ksef_lookup_exchange_rateA

Fetch official NBP exchange-rate data; advisory and requires basis confirmation.

ksef_advise_exchange_rate_basisC

Suggest the advisory NBP average rate for a VAT exchange-rate basis date.

ksef_advise_vat_treatmentB

Suggest advisory VAT treatment candidates and missing facts; never mutates drafts.

ksef_add_source_documentB

Store a local source document and index it for advisory retrieval.

ksef_search_source_documentsB

Search local source documents; returned matches are advisory provenance only.

ksef_extract_invoice_sourceB

Use a local LLM to propose source-backed invoice fields without mutating drafts.

ksef_attach_field_provenanceB

Attach source-backed field provenance to a draft and require confirmation.

ksef_start_invoice_draftC

Create an invoice draft and return the missing-field checklist.

ksef_update_invoice_draftC

Update an invoice draft with user-provided facts or confirmations.

ksef_validate_invoice_draftB

Validate invoice draft completeness before XML preparation.

ksef_prepare_invoiceA

Build and validate invoice XML without sending; refuses until TEST readiness passes.

ksef_render_invoice_pdfB

Render a local KSeF-like PDF from prepared FA(3) XML without sending to KSeF.

ksef_submit_invoiceA

Irreversibly issues a legally binding invoice to KSeF. Requires a confirmation_token from ksef_prepare_invoice.

Prompts

Interactive templates invoked by user choice

NameDescription
first-use-setupGuide the local TEST-first setup and first safe invoice flow.
issue-invoiceGuide an invoice draft through source gathering, validation, prepare, and submit.
monthly-reviewReview KSeF invoices for a month using read-only tools.
explain-vat-treatmentExplain possible VAT treatment using advisory sources and ask for confirmation.
extract-invoice-sourceUse local source search to propose draft fields with provenance.

Resources

Contextual data attached and managed by the client

NameDescription
fa3-schemaVendored FA(3) XSD schema used for local validation.
ksef-glossaryShort definitions for KSeF invoice workflow terms.
invoice-field-checklistCurrent deterministic required and conditional fields for draft preparation.
capabilitiesMachine-readable supported, advisory, and unsupported workflow surface.
seller-profileSanitized local seller profile, if configured.
knowledge-sourcesLocal source documents indexed for advisory retrieval.
first-use-checklistTEST-first local and manual gates before the first invoice.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/olegtyshcneko/ksef-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server