kolejki-nfz-mcp

<h1 align="center">kolejki-nfz-mcp 🏥</h1> <p align="center"> <b>Gdzie najszybciej do specjalisty na NFZ – dla Twojego asystenta AI.</b><br> Serwer <a href="https://modelcontextprotocol.io">MCP</a> z oficjalnymi danymi NFZ o kolejkach: prognozowany czas oczekiwania, liczba oczekujących, adres, telefon, odległość i dostępność poradni. Działa w Claude, ChatGPT, Cursorze i każdym kliencie MCP. </p> <p align="center"> <a href="https://www.npmjs.com/package/kolejki-nfz-mcp"><img alt="npm" src="https://img.shields.io/npm/v/kolejki-nfz-mcp?color=cb3837&label=npm"></a> <a href="https://github.com/ContentWriterco/kolejki-nfz-mcp/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/ContentWriterco/kolejki-nfz-mcp/actions/workflows/ci.yml/badge.svg"></a> <a href="LICENSE"><img alt="Licencja MIT" src="https://img.shields.io/badge/licencja-MIT-blue"></a> <img alt="Bez klucza API" src="https://img.shields.io/badge/klucz%20API-niepotrzebny-2ea44f"> </p> <p align="center"> <img src="docs/demo-pl.svg" width="860" alt="Animacja: użytkownik pyta asystenta AI, gdzie najszybciej dostanie się do okulisty na NFZ w Poznaniu; asystent korzysta z kolejki-nfz-mcp i podaje poradnie z prognozą czasu oczekiwania, adresem i telefonem"> </p> <p align="center">_{Prawdziwa odpowiedź publicznego serwera (dane NFZ, stan na 10.10.2026).}</p>

Podłącz w 30 sekund

Adres MCP: https://kolejki.compabase.com/mcp (Streamable HTTP, bez logowania).

• Claude: Ustawienia → Connectors → Add custom connector → wklej adres.
• ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.
• Claude Code: claude mcp add --transport http kolejki-nfz https://kolejki.compabase.com/mcp
• Lokalnie (stdio): npx -y kolejki-nfz-mcp, np. w Claude Desktop:

{ "mcpServers": { "kolejki-nfz": { "command": "npx", "args": ["-y", "kolejki-nfz-mcp"] } } }

Co potrafi

| Narzędzie | Do czego | |---|---| | find_care | Dla specjalności, badania albo zabiegu (zwykłymi słowami: „okulista”, „ortopeda”, „rezonans magnetyczny”, „zaćma”, „endoprotezoplastyka biodra”) i miejsca (miejscowość, adres, „lat,lon”): poradnie i szpitale z umową z NFZ w okolicy, posortowane według prognozowanego czasu oczekiwania NFZ (albo odległości), z liczbą oczekujących, średnim czasem czekania, adresem, telefonem, odległością, udogodnieniami (winda, podjazd, parking…) i informacją, czy przyjmują dzieci. Przypadek stabilny albo pilny; poradnia albo oddział szpitalny. | | find_benefits | Oficjalne nazwy świadczeń NFZ pasujące do słowa – gdy trzeba wskazać dokładne świadczenie. | | data_sources | Źródła i zastrzeżenia. |

Przykładowe pytania: „Gdzie najszybciej do endokrynologa na NFZ koło Lublina?”, „Rezonans magnetyczny na NFZ w Gdańsku – gdzie najkrótsza kolejka?”, „Ortopeda dla dziecka w Krakowie, najbliżej Nowej Huty”, „Mam skierowanie pilne do neurologa, mieszkam w Pile – dokąd?”, „Gdzie operacja zaćmy najszybciej w woj. śląskim?”.

Skąd dane

• Kolejki: Narodowy Fundusz Zdrowia – API „Terminy leczenia” 1.4 (https://apinfz.nfz.gov.pl/app-itl-api-pcus/): listy oczekujących zgłaszane przez placówki z umową z NFZ, z prognozowanym czasem uzyskania świadczenia liczonym przez NFZ. Odpowiedzi trzymamy w pamięci podręcznej (6 h) i odpytujemy API powoli, żeby go nie obciążać.
• Lokalizacja: GUGiK (państwowy rejestr adresów i granic gmin). Odległość w linii prostej – w miastach do adresu placówki, w mniejszych miejscowościach do ich centrum.
• Zastrzeżenia: prognoza to szacunek NFZ, nie rezerwacja – na wizytę zapisuje się telefonicznie lub osobiście w placówce. Nie wszystkie świadczenia mają listy oczekujących w tym API (np. zwykłe porady kardiologiczne). Szukamy w województwie wskazanego miejsca. Serwer nie jest usługą NFZ i nie udziela porad medycznych; w nagłym przypadku – 112.

Własny serwer

npx -y kolejki-nfz-mcp --http --port 3000      # MCP: http://localhost:3000/mcp
npx -y kolejki-nfz-mcp find okulista "Poznań"
npx -y kolejki-nfz-mcp find "rezonans magnetyczny" "Gdańsk, Długa 1" --sort distance
npx -y kolejki-nfz-mcp benefits zaćm

Zmienne: KOLEJKI_CACHE_HOURS, KOLEJKI_CACHE_DIR, KOLEJKI_RATE_LIMIT, KOLEJKI_STATS=1 (anonimowe liczniki pod /stats), KOLEJKI_CONTACT, KOLEJKI_PUBLIC_URL.

Licencja

Kod: MIT. Dane: Narodowy Fundusz Zdrowia (dane publiczne, API „Terminy leczenia”), GUGiK – dane przetworzone. Projekt niezależny, niezwiązany z NFZ, hostowany pro publico bono przez Compabase. Zobacz też leki-mcp, powietrze-mcp, szkoly-mcp, rozklad-mcp i ceny-nieruchomosci-mcp.

---

English

<p align="center"><img src="docs/demo-en.svg" width="860" alt="Animation: a user asks an AI assistant where to see an ophthalmologist on NFZ soonest in Poznań; the assistant uses kolejki-nfz-mcp and lists clinics with the forecast waiting time, address and phone"></p>

kolejki-nfz-mcp gives AI assistants NFZ waiting times in Poland: for a specialist visit, diagnostic test or procedure (in everyday Polish words) near a place, it lists clinics and hospitals with an NFZ contract sorted by NFZ's forecast waiting time, with the number of people waiting, address, phone, distance, accessibility and whether children are seen. Stable or urgent cases. Data: NFZ "Terminy leczenia" API (public data). Public endpoint: https://kolejki.compabase.com/mcp (no key), or run locally with npx -y kolejki-nfz-mcp. Not affiliated with NFZ; the forecast is not a booking.