Kalkulatory Place

io.github.grynienMv1.0.2更新於 Oct 7, 2026

Polish payroll: gross↔net salary, hourly rates, tax brackets and ZUS rates from a live public API

已驗證STDIO僅桌面Data & Analytics Finance

概覽

AI 產生的概覽

讓助理透過公開 API 計算波蘭薪資數據——稅前轉稅後、時薪，以及各年度的 PIT 與 ZUS 費率。

功能: 提供五個工具處理波蘭薪資計算：由稅前金額算稅後（僱傭契約與民事契約、逐項 ZUS 與醫療分攤、PIT 預繳、雇主成本、26 歲以下減免、年度合計）、由目標稅後回推稅前、由稅前時薪算稅後，以及查詢某年度的法定費率（最低工資、免稅額度、PIT 稅率級距、ZUS 費率、30 倍上限）。目錄工具列出支援的年度、金額範圍與 API 網址格式。每個回應都包含法律查核日期、該年度費率是最終版或仍為草案，以及可讀明細的連結。
適用情境: 當助理需要回答波蘭薪資問題、而憑記憶給出的 PIT 與 ZUS 費率可能錯誤或過時時適用，例如從稅前報價推算實領薪資，或回推達到目標稅後所需的稅前金額。它是計算輔助，不構成稅務建議。
執行需求: 透過 npx 從 npm 套件 @kalkulatory-place/mcp 以 stdio 在本機執行；需要 Node.js 以及連線該公開 API 的網路。無需 API 金鑰或帳號。可選變數 KALKULATORY_API 可覆寫基礎網址，例如指向本機建置。

安裝前請注意

計算結果僅供參考，服務方聲明其並非稅務顧問；結果取決於該年度費率，而該費率可能仍是草案。伺服器會把你詢問的金額透過 HTTPS 傳送給第三方公開 API。不涉及憑證、付款或寫入操作。

安裝

在 SourceWeft 中

開啟儀表板中的 Kalkulatory Place，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

Kalkulatory Płace — MCP server

[npm] [license] [test]

Polish payroll for AI assistants. Five MCP tools that turn "how much do I take home from 11 600 PLN gross?" from a guess into an answer that matches the actual bank transfer to the cent.

Ask a model this today and it computes from memory. Polish PIT and ZUS rates change every year, the income-tax advance rounds to whole złoty, the health contribution has a statutory cap, and the answer is quietly wrong. This server hands the model a precomputed answer from the same engine that renders kalkulatory-place.pl, so the number in the chat and the number on the linked page are identical.

No API key. No rate limits. No npm dependencies.

Install

Any other MCP client (claude_desktop_config.json and friends):

json

{  "mcpServers": {    "kalkulatory-place": {      "command": "npx",      "args": ["-y", "@kalkulatory-place/mcp"]    }  }}

{  "mcpServers": {    "kalkulatory-place": {      "command": "npx",      "args": ["-y", "@kalkulatory-place/mcp"]    }  }}

Tools

Tool	Answers
`brutto_na_netto`	Net pay from a gross amount — employment contract (itemised ZUS, health, PIT advance), civil-law contracts, employer cost, under-26 exemption, yearly totals
`netto_na_brutto`	The gross salary needed to take home a given net amount
`stawka_godzinowa`	Net from an hourly gross rate — civil-law contract and employment
`stawki_roku`	Minimum wage, tax-free allowance, PIT brackets, ZUS rates, 30× cap for a given year
`katalog`	Supported years, amount ranges, API URL patterns

Every response carries stanPrawnyNa (the date the law was checked), statusRocznika (final or projekt — the year's rates are still a draft bill) and zrodlo, a URL to the full human-readable breakdown.

How it works

A thin client over a static JSON API: plain GETs off a CDN, no key, no limits.

Why a thin client and not a copy of the engine. The numbers must be identical to what the user sees after clicking zrodlo. A server doing its own maths would silently drift apart the first time rates changed upstream — and the drift would be noticed by whoever was shown the wrong number.

Why no dependencies. MCP is handled directly as newline-framed JSON-RPC 2.0 over stdio. A package with no dependencies starts under npx in about a second and cannot break when somebody else's SDK updates under a server everyone has forgotten about.

The underlying API is public and documented in OpenAPI 3.1: https://kalkulatory-place.pl/openapi.json. There is also an llms.txt.

Configuration

Test

Runs a real handshake against the published server: initialize, tools/list, then a brutto_na_netto call, and checks the result against the published net figure.

License

Code: MIT. Data and calculations: CC BY 4.0 — when quoting a number, cite the URL from zrodlo. See NOTICE.

This is not tax advice. Figures are informational.

Po polsku

Serwer MCP do liczenia polskich wynagrodzeń. Daje asystentowi AI pięć narzędzi zamiast zgadywania stawek PIT i ZUS z pamięci.

Odpowiedzi pochodzą z kalkulatory-place.pl — z tego samego silnika, który renderuje strony serwisu, więc liczba w czacie zgadza się co do grosza z tym, co użytkownik zobaczy po kliknięciu w link źródłowy.

Narzędzie	Odpowiada na
`brutto_na_netto`	Ile netto z X zł brutto — etat (z rozbiciem na składki), zlecenie, dzieło, koszt pracodawcy, ulga do 26 lat, sumy roczne
`netto_na_brutto`	Jakie brutto daje X zł netto na etacie
`stawka_godzinowa`	Ile netto ze stawki X zł/h — zlecenie i etat
`stawki_roku`	Płaca minimalna, kwota wolna, progi PIT, stopy składek ZUS, limit 30-krotności
`katalog`	Obsługiwane roczniki i zakresy kwot

Każda odpowiedź niesie stanPrawnyNa, statusRocznika (final albo projekt — rocznik jeszcze nieuchwalony) oraz zrodlo, czyli adres strony z pełnym rozbiciem dla człowieka.

Instalacja bez klucza API i bez zależności:

Wydawca: Bril Brothers Innovation Labs sp. z o.o., KRS 0001262781. Serwis nie jest doradcą podatkowym; wyliczenia mają charakter informacyjny.

來源：README.md，提交 0ce8672

工具

工具後設資料尚未被收錄。

版本歷史

v1.0.2最新Oct 7, 2026