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