Back to Directory/Developer Tools

io.github.gabrielmahia/afya-mcp

MCP server for health-service coordination in East Africa (afya = health)

Developer ToolsPythonv0.1.4

afya-mcp

afya-mcp Glama score smithery badge


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 — 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
pip install africa-coord-bus

All servers: 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. Security reports: see SECURITY.md.

Part of the East Africa coordination stack

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx afya-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-gabrielmahia-afya-mcp": {
      "command": "uvx",
      "args": [
        "afya-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

afya-mcppypi

Compatible MCP Clients

io.github.gabrielmahia/afya-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More