# kolejki-nfz-mcp

kolejki-nfz-mcp is a Claude Code MCP server that finds Polish NFZ providers, tests and treatments by expected waiting time.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15 repo stars
- Author: ContentWriterco
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ContentWriterco/kolejki-nfz-mcp
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kolejki-nfz-mcp

## What it does

kolejki-nfz-mcp searches NFZ-contracted clinics and hospitals for a named specialty, diagnostic test or treatment near a place. Results can be ordered by the NFZ waiting-time forecast or by distance, with waiting counts, contact details, accessibility features and child-patient availability.

It combines the public NFZ “Terminy leczenia” API with GUGiK location data. The hosted service is available at `https://kolejki.compabase.com/mcp` without an API key; a local process runs through `npx -y kolejki-nfz-mcp`. The forecast is an estimate rather than an appointment booking, so registration happens directly with the facility.

Searches cover the voivodeship tied to the supplied location, and some services have no waiting lists in this API. The server is independent of NFZ and does not provide medical advice.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://kolejki.compabase.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http kolejki-nfz-mcp https://kolejki.compabase.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add kolejki-nfz-mcp -- npx -y kolejki-nfz-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add kolejki-nfz-mcp --url https://kolejki.compabase.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add kolejki-nfz-mcp -- npx -y kolejki-nfz-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kolejki-nfz-mcp": {
            "url": "https://kolejki.compabase.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kolejki-nfz-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kolejki-nfz-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kolejki-nfz-mcp": {
            "type": "http",
            "url": "https://kolejki.compabase.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kolejki-nfz-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kolejki-nfz-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http kolejki-nfz-mcp https://kolejki.compabase.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add kolejki-nfz-mcp npx -y kolejki-nfz-mcp
```

## When to use it
- locate an NFZ specialist near a Polish town
- rank clinics by expected waiting time
- find an NFZ site for a scan or procedure
- check child access and clinic accessibility

## Example prompts
- Find the quickest NFZ endocrinology appointment near Lublin.
- Compare NFZ MRI options in Gdansk by expected waiting time.
- Locate the nearest NFZ orthopaedist for a child near Nowa Huta in Krakow.

## Similar
- [nfz](https://affpapa.org/en/nevibecode/skills/nfz.md) — skill · ★ 60 repo stars
- [FHIR MCP Server](https://affpapa.org/en/nevibecode/mcp/fhir-mcp-server.md) — MCP server · ★ 139 repo stars
- [GTH Intelligence — Substance Abuse Treatment Finder](https://affpapa.org/en/nevibecode/mcp/gth-intelligence-substance-abuse-treatment-finder.md) — MCP server · 357 installs
- [npi-providers-mcp-server](https://affpapa.org/en/nevibecode/mcp/npi-providers-mcp-server.md) — MCP server · 275 installs
- [hipaa-compliance](https://affpapa.org/en/nevibecode/skills/affaan-m-hipaa-compliance.md) — skill · 6200 installs
- [deweloperuch.pl (unofficial)](https://affpapa.org/en/nevibecode/mcp/deweloperuchpl-unofficial.md) — MCP server · ★ 29 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
