Skip to main content
Glama
README.md
# afya-mcp
<!-- mcp-name: io.github.gabrielmahia/afya-mcp -->

[![afya-mcp Glama score](https://glama.ai/mcp/servers/gabrielmahia/afya-mcp/badges/score.svg)](https://glama.ai/mcp/servers/gabrielmahia/afya-mcp)
[![smithery badge](https://smithery.ai/badge/@gabrielmahia/afya-mcp)](https://smithery.ai/server/@gabrielmahia/afya-mcp)


---
**Compatible with `claude-sonnet-5`** (released 2026-06-30) — Anthropic's most agentic
Sonnet yet. Runs multi-step tool chains end-to-end without stopping short.
Install: `pip install afya-mcp` · Use with any MCP client.

---

MCP server for Kenya health system navigation — NHIF coverage, facility finder, maternal health, CHW support, and essential medicines. 6 tools.

## Part of the East Africa Coordination Stack

This MCP server is one of 32 tools in the Kenya coordination infrastructure.
It connects to [`africa-coord-bus`](https://github.com/gabrielmahia/africa-coord-bus) — the coordination
event bus that routes signals between domains automatically.

When this server detects a threshold condition, the bus notifies:
- `bima-mcp` — parametric insurance evaluation
- `kilimo-mcp` — agricultural advisory
- `afya-mcp` — health surveillance activation
- `county-mcp` — county office alert

```python
pip install africa-coord-bus
```

All servers: [pypi.org/user/gmahia](https://pypi.org/user/gmahia/)
## AI Architecture: Health Domain RAG

Medical AI requires grounding — ungrounded responses in health contexts cause real harm.
Use this server as a **RAG entry point**, not a standalone health oracle.

**Research basis:**
- *RAG Best Practices for Medical Domain* (2026): RAG outperforms chain-of-thought
  on complex medical reasoning and is more interpretable — critical in clinical contexts.
- *AfricaNLP 2025/2026*: Only 4 African languages (incl. Swahili) have consistent
  NLP support. Healthcare is identified as the highest-priority domain needing
  accurate, grounded AI — and the one with the most critical data gaps.
- *Multilingual NLP for African Healthcare* (AfricaNLP 2025): Bias and translation
  errors persist specifically in African health AI contexts.

**Appropriate use:**
✅ Health facility navigation, NHIF coverage lookup, community health worker support  
✅ Health information grounded in verified Kenya health system data  
✅ Triage to appropriate care level  
❌ Diagnosis, prescription, or clinical decision-making (human-in-the-loop required)

## IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Demo data is labeled DEMO and is not suitable for operational decisions. Full policy: [docs/architecture/IP_POLICY.md](docs/architecture/IP_POLICY.md). Security reports: see [SECURITY.md](SECURITY.md).

<!-- interconnect:v1 -->
## Part of the East Africa coordination stack

- **Install & run:** `pip install reli-cli && reli list` — 33 MCP servers on the [official MCP Registry](https://registry.modelcontextprotocol.io) under `io.github.gabrielmahia`
- **Evaluate any model on Swahili agent tasks:** [kipimo](https://github.com/gabrielmahia/kipimo) · [dataset](https://huggingface.co/datasets/gmahia/kipimo) · [leaderboard](https://huggingface.co/spaces/gmahia/kipimo-leaderboard)
- **Coordinate across servers:** [africa-coord-bus](https://pypi.org/project/africa-coord-bus/) — offline-first event bus with a built-in Kenya routing table
- **Datasets:** [huggingface.co/gmahia](https://huggingface.co/gmahia) · **Docs hub:** [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack)

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.
<!-- /interconnect:v1 -->

TDQS

B3.1/5.0

Scored across 6 tools

Disambiguation5/5

Each tool addresses a distinct domain within Kenya healthcare (CHW services, medicines, facilities, rights, maternal health, NHIF coverage). No two tools overlap in purpose, ensuring clear selection.

Naming Consistency4/5

All names use lowercase with underscores and follow a 'domain_operation' pattern, but the operation terms vary: 'lookup', 'finder', 'query', 'guide'. This minor inconsistency prevents a perfect score.

Tool Count5/5

Six tools is appropriate for a focused healthcare demo. The set covers key information areas without being overwhelming or too sparse.

Completeness4/5

The tools cover essential health information queries for Kenya. While additional tools like immunization schedules or disease-specific guides could be added, the current set covers major user needs with minor gaps.

Maintenance

ActivityStale
ResponsivenessNo issues