# Nöbetçi Eczane: MCP server and browser extension

Today's on-duty pharmacies (*nöbetçi eczane*) for all 81 provinces of Türkiye and the TRNC (KKTC), from [NobetciEczane.org](https://nobetcieczane.org/).

This repository contains:

- **MCP server** documentation: a free, public, read-only remote server at `https://nobetcieczane.org/mcp`. It is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/org.nobetcieczane%2Fnobetci-eczane/versions/latest) as `org.nobetcieczane/nobetci-eczane`.
- **Browser extension** source code (Chrome, Edge, Opera, Firefox) in [`extension/`](extension/).

[Türkçe açıklama aşağıda.](#türkçe)

## MCP server

| | |
|---|---|
| URL | `https://nobetcieczane.org/mcp` |
| Transport | Streamable HTTP, stateless |
| Authentication | None |
| Rate limit | 60 requests per minute per IP |

### Tools

| Tool | Parameters | Returns |
|---|---|---|
| `nobetci_eczane_listele` | `il`: province name, slug or plate code (`"İstanbul"`, `"istanbul"`, `"34"`; `"kktc"` for the TRNC)<br>`ilce` (optional): district name or slug (`"Kadıköy"`)<br>`limit` (optional, 1–100, default 30) | On-duty pharmacies for that province or district: name, province, district and address, plus the page URL (phone numbers, duty hours and directions are on that page) |
| `en_yakin_nobetci_eczane` | `enlem`, `boylam`: latitude and longitude (WGS84)<br>`adet` (optional, 1–20, default 5) | The nearest on-duty pharmacies, closest first: name, province, district, address and page URL |

Both tools are read-only. The duty day changes at 09:00 Türkiye time; before 09:00 the previous day's list is still in effect. Province and district names can be typed with or without Turkish characters, and common aliases (`antep`, `urfa`, `maras`, `kibris`…) work.

### Connect

**Claude** (claude.ai, desktop and mobile): Settings → Connectors → Add custom connector → URL `https://nobetcieczane.org/mcp`.

**Claude Code**

```bash
claude mcp add --transport http nobetci-eczane https://nobetcieczane.org/mcp
```

**ChatGPT** (developer mode): add a connector with the URL `https://nobetcieczane.org/mcp` and no authentication.

**Cursor** (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "nobetci-eczane": { "url": "https://nobetcieczane.org/mcp" }
  }
}
```

**VS Code** (`.vscode/mcp.json`)

```json
{
  "servers": {
    "nobetci-eczane": { "type": "http", "url": "https://nobetcieczane.org/mcp" }
  }
}
```

**Gemini CLI** (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "nobetci-eczane": { "httpUrl": "https://nobetcieczane.org/mcp" }
  }
}
```

### Privacy

Each tool call is logged anonymously for usage statistics: tool name, client name and version, province and district slug, result count, success and duration. IP addresses, coordinates and free-text queries are **not** stored. See the [privacy notice (KVKK)](https://nobetcieczane.org/kvkk).

## Browser extension

Pick a province and district to see today's on-duty pharmacies with their names and addresses; a link opens the full page with phone numbers, duty hours and directions. The extension has no account or tracking, and it stores only the last selection in the browser. It reads the public province and district pages of nobetcieczane.org; see [`extension/README.md`](extension/README.md).

## Data, attribution and safety

Pharmacy data is compiled by NobetciEczane.org from public sources: provincial chambers of pharmacists, e-Nabız and the Cyprus Turkish Pharmacists' Association (KTEB). **The MIT license covers the code in this repository, not the data.** If you show results to users, please credit and link [NobetciEczane.org](https://nobetcieczane.org/).

Duty lists can change at short notice: call the pharmacy before you go. A pharmacy marked *icap* is closed and opens only on call. This is not medical advice; in an emergency call 112.

## License

Code: [MIT](LICENSE). The Google Sans Flex font in `extension/fonts/` is under the [SIL Open Font License 1.1](extension/fonts/OFL.txt).

---

## Türkçe

Türkiye'nin 81 ili ve KKTC için güncel nöbetçi eczaneler, [NobetciEczane.org](https://nobetcieczane.org/)'dan.

- **MCP sunucusu:** `https://nobetcieczane.org/mcp`. Ücretsiz, herkese açık ve salt okunur; kimlik doğrulama yok. İki araç sunar: il/ilçeye göre listeleyen `nobetci_eczane_listele` ve koordinata göre en yakınları bulan `en_yakin_nobetci_eczane`. Bağlantı ayarları yukarıda.
- **Tarayıcı eklentisi:** İl ve ilçe seçin, o günün nöbetçi eczanelerini adları ve adresleriyle görün; telefon ve nöbet saatleri için sitedeki sayfaya geçin. Kaynak kodu [`extension/`](extension/) klasöründe.

Nöbet günü her sabah 09:00'da (Türkiye saati) değişir. Gitmeden önce eczaneyi arayın. İcap nöbetindeki eczane kapalıdır, yalnız çağrı üzerine açılır. Acil durumlarda 112'yi arayın.

MIT lisansı yalnız bu depodaki kodu kapsar, nöbet verisini kapsamaz. Sonuçları kullanıcılarınıza gösterirseniz kaynak olarak [NobetciEczane.org](https://nobetcieczane.org/)'u bağlantısıyla belirtin.