# 💧 WapiMaji MCP — Kenya Water & Drought Intelligence
<!-- mcp-name: io.github.gabrielmahia/wapimaji-mcp -->

[![wapimaji-mcp Glama score](https://glama.ai/mcp/servers/gabrielmahia/wapimaji-mcp/badges/score.svg)](https://glama.ai/mcp/servers/gabrielmahia/wapimaji-mcp)
[![smithery badge](https://smithery.ai/badge/@gabrielmahia/wapimaji-mcp)](https://smithery.ai/server/@gabrielmahia/wapimaji-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 wapimaji-mcp` · Use with any MCP client.

---


> MCP server giving AI agents real-time access to Kenya's water stress and drought data — all 47 counties, NDMA drought phase classifications, and SMS alert capability via Africa's Talking.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://python.org)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)

## What it does

WapiMaji MCP exposes Kenya drought and water stress data as MCP tools. Any Claude, GPT-4, or MCP-compatible AI agent can now:

- Query live drought phase data for any of Kenya's 47 counties
- Get water stress indices from NDMA drought monitor
- Send SMS alerts to farmers via Africa's Talking when drought levels spike

**One-prompt examples:**

```
"What is the current drought phase in Marsabit County?"
→ Gets NDMA Phase 3 classification + rainfall deficit data

"Which counties are in drought emergency right now?"
→ Returns all counties at Phase 3+ with population affected

"SMS these 500 Garissa farmers: drought phase has escalated to 3"
→ Sends alerts via Africa's Talking across Safaricom + Airtel
```

## Tools

| Tool | Type | Description |
|------|------|-------------|
| `get_drought_status` | Read-only | Current NDMA drought phase for a county |
| `get_county_water_stress` | Read-only | Water stress index, rainfall deficit, river levels |
| `get_drought_alerts` | Read-only | All counties at or above a given drought phase |
| `sms_drought_alert` | Destructive | Send drought alert SMS via Africa's Talking |

## Install

```bash
pip install wapimaji-mcp
# or:
uvx wapimaji-mcp
```

## Configure

```json
{
  "mcpServers": {
    "wapimaji": {
      "command": "uvx",
      "args": ["wapimaji-mcp"],
      "env": {
        "AT_USERNAME": "your_username",
        "AT_API_KEY": "your_at_key",
        "SANDBOX": "true"
      }
    }
  }
}
```

## Data sources

- **NDMA** — National Drought Management Authority drought phase classifications
- **Kenya Meteorological Department** — rainfall data
- **FEWS NET** — Famine Early Warning System food security projections

## Related

- [mpesa-mcp](https://pypi.org/project/mpesa-mcp/) — M-Pesa + Africa's Talking MCP server
- [WapiMaji](https://wapimaji.streamlit.app) — The Streamlit dashboard version
- [gabrielmahia.github.io](https://gabrielmahia.github.io) — Full civic portfolio

## IP & Collaboration

© 2026 Gabriel Mahia · [contact@aikungfu.dev](mailto:contact@aikungfu.dev)
License: MIT
Not affiliated with NDMA or Africa's Talking.


## Data Sources

This server draws on open and public domain datasets for drought intelligence:

**Open Government Data (Public Domain)**
- NASA MODIS NDVI — vegetation index for drought early warning
- NOAA CHIRPS — daily rainfall estimates (0.05° resolution)
- NASA TRMM — monthly precipitation
- USDA FEWS NET — East Africa livelihood zones

**Historical Baseline Data (Public Domain)**
- East Africa Meteorological Records 1900-1940 (colonial era, PD)
- Kew Gardens East Africa Survey 1910 (botanical PD)

These are structured in [africa-open-climate-data](https://huggingface.co/datasets/gmahia/africa-open-climate-data)
and [east-africa-agricultural-pd](https://huggingface.co/datasets/gmahia/east-africa-agricultural-pd).

## Part of the East Africa Coordination Stack

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

```bash
pip install africa-coord-bus
```

All 32 servers: [pypi.org/user/gmahia](https://pypi.org/user/gmahia/)
Live demo: [coord-cascade-demo](https://github.com/gabrielmahia/coord-cascade-demo)

<!-- 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 -->