API i serwer MCP

Asystent AI zapytany „ile netto z 11 600 brutto" liczy z pamięci — i mija się z przelewem, bo stawki PIT i ZUS zmieniają się co roku, a zaliczka zaokrągla się do pełnych złotych. Udostępniamy więc te same wyliczenia, które widzisz na stronach, w formie czytelnej dla maszyny: jeden plik JSON na jedno pytanie.

Bez klucza, bez rejestracji, bez limitów. Licencja CC BY 4.0 — przy cytowaniu liczby wskaż adres z pola zrodlo.

Model Context Protocol to standard, którym asystenci AI sięgają po zewnętrzne narzędzia. Nasz serwer daje im cztery: brutto_na_netto, netto_na_brutto, stawka_godzinowa i stawki_roku.

Claude Code:

claude mcp add kalkulatory-place -- npx -y @kalkulatory-place/mcp

Claude Desktop i inni klienci MCP — w pliku konfiguracyjnym:

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

Pakiet nie ma żadnych zależności i nie wymaga instalacji — npx pobiera go przy pierwszym uruchomieniu.

Zwykłe GET-y, odpowiedź w JSON-ie:

• /api/v1/index.json — katalog: roczniki, zakresy kwot, wzorce adresów
• /api/v1/brutto-netto/{kwota}.json — ile netto z kwoty brutto
• /api/v1/netto-brutto/{kwota}.json — jakie brutto daje zadane netto
• /api/v1/stawka-godzinowa/{stawka}.json — ile netto ze stawki za godzinę
• /api/v1/stawki/{rok}.json — płaca minimalna, kwota wolna, progi PIT, składki

Rocznik można pominąć — wtedy odpowiedź dotyczy roku bieżącego; albo wstawić przed kwotą: /api/v1/brutto-netto/2025/8000.json. Specyfikacja: OpenAPI 3.1. Spis treści dla modeli: llms.txt.

Poza samą liczbą każda odpowiedź niesie trzy rzeczy, bez których cytowanie wyniku byłoby nieuczciwe:

• stanPrawnyNa — na jaki dzień obowiązują użyte stawki;
• statusRocznika — final albo projekt (rocznik jeszcze nieuchwalony);
• zrodlo — adres strony, na której człowiek zobaczy to samo wyliczenie z pełnym rozbiciem.

Wyliczenia mają charakter poglądowy i nie stanowią porady podatkowej (regulamin). Szukasz kalkulatora do osadzenia na własnej stronie? Widget.