![\"npm\"](\"https://img.shields.io/npm/v/kolejki-nfz-mcp?color=cb3837&label=npm\")
\n ![\"CI\"](\"https://github.com/ContentWriterco/kolejki-nfz-mcp/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"Licencja](\"https://img.shields.io/badge/licencja-MIT-blue\"){kind=icon}
\n ![\"Bez](\"https://img.shields.io/badge/klucz%20API-niepotrzebny-2ea44f\"){kind=icon}
\n\n Gdzie najszybciej do specjalisty na NFZ – dla Twojego asystenta AI.
\n Serwer MCP 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.\n
\n \n
\n ![\"Animacja:](\"docs/demo-pl.svg\")
\n
Prawdziwa odpowiedź publicznego serwera (dane NFZ, stan na 10.10.2026).
\n\n## Podłącz w 30 sekund\n\nAdres MCP: **`https://kolejki.compabase.com/mcp`** (Streamable HTTP, bez logowania).\n\n- **Claude:** Ustawienia → Connectors → *Add custom connector* → wklej adres.\n- **ChatGPT:** Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.\n- **Claude Code:** `claude mcp add --transport http kolejki-nfz https://kolejki.compabase.com/mcp`\n- **Lokalnie (stdio):** `npx -y kolejki-nfz-mcp`, np. w Claude Desktop:\n\n```json\n{ \"mcpServers\": { \"kolejki-nfz\": { \"command\": \"npx\", \"args\": [\"-y\", \"kolejki-nfz-mcp\"] } } }\n```\n\n## Co potrafi\n\n| Narzędzie | Do czego |\n|---|---|\n| `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. |\n| `find_benefits` | Oficjalne nazwy świadczeń NFZ pasujące do słowa – gdy trzeba wskazać dokładne świadczenie. |\n| `data_sources` | Źródła i zastrzeżenia. |\n\n**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?”.\n\n## Skąd dane\n\n- **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ć.\n- **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.\n- **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.\n\n## Własny serwer\n\n```bash\nnpx -y kolejki-nfz-mcp --http --port 3000 # MCP: http://localhost:3000/mcp\nnpx -y kolejki-nfz-mcp find okulista \"Poznań\"\nnpx -y kolejki-nfz-mcp find \"rezonans magnetyczny\" \"Gdańsk, Długa 1\" --sort distance\nnpx -y kolejki-nfz-mcp benefits zaćm\n```\n\nZmienne: `KOLEJKI_CACHE_HOURS`, `KOLEJKI_CACHE_DIR`, `KOLEJKI_RATE_LIMIT`, `KOLEJKI_STATS=1` (anonimowe liczniki pod `/stats`), `KOLEJKI_CONTACT`, `KOLEJKI_PUBLIC_URL`.\n\n## Licencja\n\nKod: 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](https://compabase.com). Zobacz też [leki-mcp](https://github.com/ContentWriterco/leki-mcp), [powietrze-mcp](https://github.com/ContentWriterco/powietrze-mcp), [szkoly-mcp](https://github.com/ContentWriterco/szkoly-mcp), [rozklad-mcp](https://github.com/ContentWriterco/rozklad-mcp) i [ceny-nieruchomosci-mcp](https://github.com/ContentWriterco/ceny-nieruchomosci-mcp).\n\n---\n\n## English\n\n![\"Animation:](\"docs/demo-en.svg\")