Kolejki Nfz Mcp

io.github.ContentWritercoPublished by GitHub account ContentWritercov0.1.0Updated Oct 24, 2026

NFZ waiting times in Poland: where a specialist, test or treatment is available soonest

VerifiedStreamable HTTPWeb executableLocation & LifestyleKnowledge & Memory

Overview

AI-generated overview

Looks up Polish NFZ waiting times: finds clinics and hospitals near a place with the shortest forecast wait for a specialist, test or treatment.

What you can do
Find care: search clinics and hospitals with an NFZ contract near a town or address for a specialist, test or treatment given in everyday words, sorted by NFZ forecast waiting time or distance, with queue size, address, phone, distance, accessibility and whether children are seen; stable or urgent cases, for adults or children. Look up benefits: match a word to official NFZ benefit names to use as the exact benefit in a care search. Check data sources: see where the data comes from and its caveats.
When to use it
Useful when someone in Poland asks where they can get an NFZ-paid specialist visit, diagnostic test or procedure soonest near a given place, including urgent referrals or care for a child.
Requirements
Either the public remote endpoint (Streamable HTTP, no login) or a local process via npx, which needs Node.js. No API key or account. Network access to the server and the underlying public NFZ and address-register data.
Before you install
Results are NFZ forecasts, not bookings; the patient still registers by phone or in person. Not every service has waiting lists in the source data, and searches cover the voivodeship of the given place. The project is independent of NFZ and gives no medical advice. Optional local settings such as cache and rate-limit variables exist.

Installation

In SourceWeft

  1. Open Kolejki Nfz Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ContentWriterco%2Fkolejki-nfz-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "kolejki-nfz": {
      "type": "http",
      "url": "https://kolejki.compabase.com/mcp"
    }
  }
}

README

kolejki-nfz-mcp 🏥

Gdzie najszybciej do specjalisty na NFZ – dla Twojego asystenta AI.
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.

[npm] [CI] [Licencja MIT] [Bez klucza API]

[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]

Prawdziwa odpowiedź publicznego serwera (dane NFZ, stan na 10.10.2026).

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:
json
{ "mcpServers": { "kolejki-nfz": { "command": "npx", "args": ["-y", "kolejki-nfz-mcp"] } } }

Co potrafi

NarzędzieDo czego
find_careDla 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_benefitsOficjalne 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

bash
npx -y kolejki-nfz-mcp --http --port 3000      # MCP: http://localhost:3000/mcpnpx -y kolejki-nfz-mcp find okulista "Poznań"npx -y kolejki-nfz-mcp find "rezonans magnetyczny" "Gdańsk, Długa 1" --sort distancenpx -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

[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]

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.

Source: README.md at commit 5b1ea7a

Tools

3

find_care

Shortest NFZ waiting times near a place

Where a specialist, diagnostic test or treatment paid by NFZ is available soonest near a place in Poland. Returns clinics and hospitals with NFZ's forecast waiting time, people in the queue, address, phone, distance, accessibility and whether children are seen. service: everyday words (okulista, kardiolog, rezonans, zaćma, rehabilitacja…) or an exact NFZ benefit name from find_benefits. place: town, address or 'lat,lon'.

Parametersmaxsortplacerequiredurgentbenefitservicerequiredchildrenhospitalradius_km

find_benefits

NFZ benefit names

Look up official NFZ benefit names (clinics, wards, tests, procedures) matching a word, e.g. 'rezonans' or 'okulist'. Use the exact name as find_care.benefit.

Parametersqueryrequired

data_sources

Data sources

Where the data comes from and caveats.

Takes no parameters.

Version history

1
  1. v0.1.0LatestOct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts