Skip to main content

Swahili Health MCP

Kenya county-level maternal health, child immunization and child stunting indicators for AI agents, from the DHS Program's Kenya Demographic and Health Survey 2022. Real survey data, bundled in the package (works offline), with the source, survey year, reference period and sample size on every answer.

PyPI version License: MIT

Tools

Tool What it does
list_health_indicators The 11 indicators held (id, label, population, whether higher or lower is better) and the survey they come from. Call this first.
get_county_health_profile Every indicator for one county.
get_maternal_health_indicators Antenatal visits (4+), antenatal care from a skilled provider, skilled assistance at delivery, health-facility delivery, no postnatal checkup.
get_immunization_coverage Children 12-23 months who received BCG, DPT3, measles, were fully vaccinated (8 basic antigens) or received none.
compare_counties Rank the counties on one indicator: where is need greatest, where is coverage best.

All 47 counties, Nairobi included. An unknown county or vaccine is an error that lists the valid values; nothing is guessed or defaulted.

Install and use

pip install swahili-health-mcp
claude mcp add swahili-health -- swahili-health-mcp      # or: uvx swahili-health-mcp

Then ask: "Which five counties have the lowest DPT3 coverage?", "Compare antenatal care in Turkana and Nairobi."

What these numbers are, and are not

  • Survey estimates, not routine facility reporting (KHIS). Each carries sampling error; county samples are small, so close values are not reliably different (the sample size n is in every answer).
  • The reference period is the DHS-preferred one (the two years before the survey). DHS also publishes a three-year period for the same counties; this server deliberately uses one.
  • Data: The DHS Program, Kenya DHS 2022 (KNBS and ICF), retrieved from api.dhsprogram.com and bundled as swahili_health_mcp/data/kdhs2022_counties.json. Rebuild it with python scripts/refresh_kdhs.py (needs network; the server does not).
  • Not clinical advice and not an operational record. There is no facility register, disease surveillance or health-worker data here: earlier versions advertised some of those and did not deliver them (see below).

Changes in 0.2.0 (breaking)

  • Replaced synthetic demo numbers (identical for every county) with real KDHS 2022 county estimates.
  • Removed the demo facility list (unverified details). A real facility register (Kenya Master Health Facility List) is not integrated yet.
  • The README previously listed tools that never existed (get_disease_surveillance, get_health_worker_count, and others); the tool list above is exactly what the server exposes, and a test enforces it.
  • Moved from a hand-rolled JSON-RPC loop to FastMCP 4, which serves both the legacy and the stateless 2026-07-28 MCP protocol revisions.

IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Survey estimates are not suitable for clinical or 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.

Metadata

Release files for swahili-health-mcp 0.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swahili-health-mcp 0.2.5
File Size Uploaded Provenance
swahili_health_mcp-0.2.5.tar.gz 18.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for swahili-health-mcp 0.2.5
File Interpreter ABI Platform
swahili_health_mcp-0.2.5-py3-none-any.whl Python 3 none any Details

Total release size: 33.2 kB

Release files / swahili_health_mcp-0.2.5.tar.gz

Download URL swahili_health_mcp-0.2.5.tar.gz
Size 18.8 kB
Tags Source
SHA-256 checksum
How to use checksums
fe50b0088f953ad25091c0b33556359a29baef1f44427e69397f0caaf6cc7535
BLAKE2b-256 checksum
How to use checksums
c2d296a34ff61424448952c71f7be0d66b0c3ad4288ba970101ad5c4b85e1e8c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / swahili_health_mcp-0.2.5-py3-none-any.whl

Download URL swahili_health_mcp-0.2.5-py3-none-any.whl
Size 14.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
070ccd0886057367350feefd33399d9217ec2de71df5664cb154a585389b3735
BLAKE2b-256 checksum
How to use checksums
d2fb2d6b7655da1f3e5d8300843dbaeab8384f8e752d001285be9ffbe1457dc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for swahili-health-mcp 0.2.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for swahili_health_mcp-0.2.5.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page