Serwer MCP Bookeper: kalkulatory podatkowe JDG dla asystentów AI

Serwer MCP Bookeper udostępnia asystentom AI, takim jak Claude, ChatGPT czy Cursor, te same kalkulatory, które działają na stronie www.bookeper.pl/kalkulatory: składki ZUS, składkę zdrowotną, ryczałt, porównanie form opodatkowania, IP Box i parametry podatkowe roku. Jest publiczny i tylko do odczytu: nie wymaga logowania ani klucza API.

Adres serwera

https://mcp.bookeper.pl/mcp

Transport: Streamable HTTP (streamable-http)
Uwierzytelnianie: brak: bez logowania i bez klucza API
Dostęp: tylko do odczytu, każde narzędzie wyłącznie liczy
Wersja: 1.0.0

Jak dodać serwer do asystenta AI

Każdy klient potrzebuje tylko adresu serwera. Nazwy menu w aplikacjach zmieniają się między wersjami; jeśli nie znajdziesz opcji, szukaj ustawień „MCP”, „konektory” albo „connectors”.

Claude (claude.ai i aplikacja desktopowa)

Otwórz Ustawienia → Konektory i wybierz „Dodaj własny konektor”. Wpisz nazwę, np. Bookeper, i wklej adres serwera. Uwierzytelnianie nie jest potrzebne.

W nowej rozmowie włącz konektor Bookeper w menu narzędzi. Dostępność własnych konektorów zależy od planu Claude.

Adres serwera

https://mcp.bookeper.pl/mcp

Claude Code

Dodaj serwer jednym poleceniem w terminalu:

Terminal

claude mcp add --transport http bookeper https://mcp.bookeper.pl/mcp

ChatGPT

Włącz tryb dewelopera (Ustawienia → Aplikacje i konektory → Zaawansowane), a następnie utwórz nowy konektor.

Wklej adres serwera i wybierz brak uwierzytelniania. Dostępność trybu dewelopera zależy od planu ChatGPT.

Adres serwera

https://mcp.bookeper.pl/mcp

Cursor

Dodaj serwer do pliku konfiguracji MCP: globalnie w ~/.cursor/mcp.json albo w projekcie w .cursor/mcp.json.

.cursor/mcp.json

{
  "mcpServers": {
    "bookeper": {
      "url": "https://mcp.bookeper.pl/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Dodaj serwer do pliku .vscode/mcp.json w projekcie (albo poleceniem „MCP: Add Server” w palecie poleceń).

.vscode/mcp.json

{
  "servers": {
    "bookeper": {
      "type": "http",
      "url": "https://mcp.bookeper.pl/mcp"
    }
  }
}

MCP Inspector (test bez asystenta)

Uruchom Inspector, wybierz transport „Streamable HTTP”, wklej adres serwera i połącz się. Zobaczysz listę narzędzi i możesz wywołać każde z nich.

Terminal

npx @modelcontextprotocol/inspector

Narzędzia (7)

Lista pochodzi z odpowiedzi serwera na zapytanie tools/list, zapisanej przy budowie tej strony. Opisy są po angielsku, dokładnie tak, jak widzi je asystent AI.

ZUS DRA: monthly social + health contributions (JDG)

calculate_zus_dra

Monthly ZUS DRA contributions of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność) for one settlement month: social insurance (składki społeczne: emerytalna, rentowa, chorobowa, wypadkowa, Fundusz Pracy) and the health contribution (składka zdrowotna). Covers the standard base, the preferential base (preferencyjne składki), the start relief (ulga na start), Mały ZUS Plus and a part month of insurance. Statute: ustawa o systemie ubezpieczeń społecznych (art. 18, 18a, 18c) and ustawa o świadczeniach opieki zdrowotnej (art. 79, 81). A concurrent employment contract (zbieg tytułów) without its monthly basis is refused with code pending_evidence. Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: zus_type, tax_form, monthly_income, yearly_revenue, business_start_date, year, month · opcjonalnych: 23

Składka zdrowotna by taxation form

calculate_health_insurance

Monthly health contribution (składka zdrowotna) of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność) under its taxation form: skala podatkowa (tax scale), podatek liniowy (flat tax) or ryczałt (lump-sum tax), with the part that is deductible. Statute: ustawa o świadczeniach opieki zdrowotnej finansowanych ze środków publicznych, art. 79 u.ś.o.z. and art. 81 u.ś.o.z. Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: tax_form, monthly_income, yearly_revenue, health_insurance_payment_status, ytd_health_insurance_deduction_applied, year, month · opcjonalnych: 6

Ryczałt (lump-sum) tax for a month

calculate_ryczalt_tax

Monthly ryczałt od przychodów ewidencjonowanych (lump-sum tax on recorded revenue) of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność): the rate, the tax due and the health contribution. The rate depends on the service, so pass exactly one rate source: tax_rate (an explicit rate in %), pkwiu_code (the PKWiU code of the service, resolved against art. 12 ust. 1 ustawy o zryczałtowanym podatku dochodowym) or pkd_activities (a mixed-rate revenue split). Without exactly one rate source the tool refuses with code rate_source_required. The tool never assumes a rate. Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: monthly_revenue, yearly_revenue, ytd_revenue, health_insurance_payment_status, ytd_health_insurance_deduction_applied, year, month · opcjonalnych: 8

B2B take-home: skala vs liniowy vs ryczałt

compare_taxation_forms

Side-by-side simulation of the yearly tax burden and take-home income of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność) under skala podatkowa (art. 27 ustawy o podatku dochodowym od osób fizycznych), podatek liniowy (art. 30c tej ustawy) and ryczałt (art. 12 ustawy o zryczałtowanym podatku dochodowym), with ZUS and the health contribution. best_form is the lowest computed burden under the stated assumptions, not a recommendation. The ryczałt row needs exactly one rate source: ryczalt_rate, pkwiu_code or pkd_activities. Without exactly one rate source the tool refuses with code rate_source_required. Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: monthly_income, yearly_revenue, ytd_revenue, unabsorbed_loss_this_year, health_insurance_payment_status, ytd_health_insurance_deduction_applied, year, month · opcjonalnych: 31

IP Box (5%) eligibility

check_ip_box_eligibility

Simplified screening of whether a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność)'s income can qualify for IP Box: the 5% rate on qualified income from qualified intellectual property rights (art. 30ca u.p.d.o.f.: ustawa o podatku dochodowym od osób fizycznych), with the warnings that apply. A screening, not a ruling: IP Box also requires separate records (ewidencja, art. 30cb u.p.d.o.f.). Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: has_qualified_ip · opcjonalnych: 1

IP Box nexus coefficient

calculate_ip_box_nexus

IP Box nexus coefficient (wskaźnik nexus) of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność) from the four cost categories of art. 30ca ust. 4 u.p.d.o.f. (ustawa o podatku dochodowym od osób fizycznych): a: own R&D, b: R&D bought from unrelated parties, c: R&D bought from related parties, d: acquired IP; and the effective rate it gives (5% × nexus). Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: own_rd_costs, acquired_unrelated_costs · opcjonalnych: 2

Polish JDG tax parameters for a year

get_tax_config

The tax and contribution parameters of a JDG (Polish sole proprietorship, osoba fizyczna prowadząca działalność) for one tax year: the minimum wage (płaca minimalna), the forecast average wage, the ZUS standard and preferential bases with the months they apply, the minimum health contribution of a skala or liniowy payer (health_insurance_minimum) and the ZUS contribution rates. health_insurance_minimum is not the ryczałt minimum: on ryczałt the health contribution follows revenue bands, so call calculate_health_insurance with tax_form ryczalt. Input: year. A cheap first call before the calculators. Statute: ustawa o systemie ubezpieczeń społecznych (art. 18, 18a). Results are simulations on the inputs given, not individual tax advice; the result equals Bookeper's public calculator at meta.canonical_url, except that calculator's internal optima_benchmark field, which is omitted. Cite meta.cite_as, link meta.canonical_url and pass on meta.assumptions.

Wymagane parametry: year

Cytowanie, założenia i zastrzeżenie

Każdy wynik zawiera podstawę prawną z numerem artykułu ustawy, założenia przyjęte w obliczeniu, gotowy tekst cytowania i link do kalkulatora na www.bookeper.pl. Serwer prosi asystenta AI, by przekazał je użytkownikowi razem z wynikiem.

Każdy wynik niesie też to zastrzeżenie:

Symulacja. Bookeper nie zastępuje doradcy podatkowego w sprawach wymagających indywidualnej porady prawno-podatkowej.

Zakres i ograniczenia

Tylko jednoosobowa działalność gospodarcza (JDG). Spółki, np. sp. z o.o., nie są obsługiwane.
Wynik jest symulacją na danych, które poda asystent. Serwer tylko liczy: niczego nie składa i niczego nie wysyła do urzędów.
Żadne narzędzie nie pyta o dane identyfikujące, takie jak imię i nazwisko, PESEL czy NIP.
Gdy brakuje danych, narzędzie odmawia zamiast zgadywać i nazywa brakujące fakty, np. stawkę ryczałtu.

To samo przez REST API

Te same obliczenia są dostępne przez zwykłe HTTPS (JSON na wejściu i na wyjściu), dla kodu, który nie korzysta z MCP. Opis wszystkich endpointów w formacie OpenAPI 3.1:

https://www.bookeper.pl/api/public/mcp/openapi.json

Wróć na stronę główną Bookeper