# Mcp Ksef

> KSeF MCP Simple Server

- **Type:** MCP server
- **Install:** `agentstack add mcp-herbat73-mcp-ksef`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [herbat73](https://agentstack.voostack.com/s/herbat73)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [herbat73](https://github.com/herbat73)
- **Source:** https://github.com/herbat73/Mcp-Ksef

## Install

```sh
agentstack add mcp-herbat73-mcp-ksef
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP KSeF Server

[](https://modelcontextprotocol.io/introduction)
[](https://opensource.org/licenses/MIT)
[](https://github.com/herbat73/Mcp-Ksef/actions/workflows/dotnet_build_and_test.yml)
[](https://hub.docker.com/r/herbat73/mcp-ksef)

To jest serwer MCP dla KSeF - Krajowy System e-Faktur to platforma do wystawiania, przesyłania, otrzymywania i przechowywania faktur.

Połączenie do KSeF wymaga wygenerowania tokenu lub certyfikatu. Obie metody są wspierane przez ten serwer MCP.

**Serwer MCP w rozwoju. Na razie działa tylko pobieranie faktur. Będą dodawane nowe funkcje.**

Spis treści

* [Jak uruchomić jako Docker](Docs/RunAsDocker.md)
* [Jak uruchomić klienta Visual Studio Code](Docs/HowToRun.md)
* [Jak uruchomić klienta Cloud Desktop](Docs/HowToRunCloudDesktop.md)
* [Przykłady użycia](Docs/Examples.md)
* [Punkty dostępu](Docs/Endpoints.md)
* [Instalacja z kodu](Docs/Installation.md)

## Co zawiera

Instrukcje dla KSeF

| Opis                                                                                                                                                               | Uzycie                 |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------|
| Pobranie faktury w XML na podstawie numeru KSeF                                                                                                                    | `#get_invoice_by_ksef` |
| Pobiera listę faktur z podanego okresu z systemu ksef oraz InvoiceSubjectType (domyślnie Subject1=wystawca), DateType (domyślnie IssueData=data wystawienienia fv) | `#query_invoices` |
| Pobiera fakturę o podanym numerze faktury (*)                                                                                                                      | `#get_invoice_by_invoice_number` |
| Pobierz faktury dla kupującego o numerze NIP (*)                                                                                                                   | `#get_invoices_for_buyer_by_nip` |
| Pobierz faktury dla kupującego o numerze VAT UE (*)                                                                                                                | `#get_invoices_for_buyer_by_vateu` |
| Pobierz link do faktury po numerze ksef                                                                                                                            | `#get_invoice_url_by_ksef` |
| Pobierz QR kod do faktury po numerze ksef                                                                                                                          | `#get_invoice_qr_ksef` |

(*) repozytorium KSeF ma ograniczenie na zwrot listy faktur do maksymalnie 3 miesiące wstecz

## Jak użyć

Użyj podobnego opisu lub użyj bezpośrednio nazwy w celu wywołania pożądanej funkcji.

Np.

```bash
Pobierz fakturę o numerze referencyjnym 5242764991-20260131-01002063FA88-AD i pokaż dane identyfkacyjne podmiotu2 oraz number faktury
```

Lub bezpośrednio
```bash
#get_invoice_by_invoice_number "FV 2026/1/31/754149652576"
```

## Przykład

Przykład użycia połączenia do KSeF w kliencie Claude Desktop

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [herbat73](https://github.com/herbat73)
- **Source:** [herbat73/Mcp-Ksef](https://github.com/herbat73/Mcp-Ksef)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-herbat73-mcp-ksef
- Seller: https://agentstack.voostack.com/s/herbat73
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.