io.github.gabrielmahia/nishati-mcp
MCP server for energy coordination in East Africa (nishati = energy)
Open source Open in the app JSON README (API)
About
MCP server for energy coordination in East Africa (nishati = energy)
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- gabrielmahia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Last push
- 2026-09-02T20:15:34Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:48
- Updated
- 2026-08-29 03:02:48
- Origin id
io.github.gabrielmahia/nishati-mcp
README
# nishati-mcp
## Why This Exists
Getting connected to power in Kenya — or deciding between grid and off-grid solar — depends on tariff bands, connection procedures and subsidy programmes that are difficult to compare side by side. Energy access decisions are long-lived and expensive to reverse, so the comparison matters more than the brochure.
## Install
```bash
pip install nishati-mcp
```
## Tools (5)
- **`kplc_connection_guide`** —
<sub>args: county, connection_type</sub>
- **`tariff_calculator`** —
<sub>args: monthly_units_kwh, customer_type</sub>
- **`solar_options_guide`** —
<sub>args: budget_kes, use_case</sub>
- **`energy_subsidy_programs`** —
<sub>args: county</sub>
- **`energy_rights_query`** —
<sub>args: topic</sub>
## Example
```python
from nishati_mcp.server import tariff_calculator
result = tariff_calculator(units_kwh=150)
# band breakdown, levies, estimated bill
```
## Claude Desktop Integration
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"nishati-mcp": {
"command": "python",
"args": ["-m", "nishati_mcp.server"]
}
}
}
```
## Data & Disclaimers
Tariffs are set by EPRA and revised periodically. Treat calculations as indicative and confirm current rates with KPLC or epra.go.ke before relying on them.
Every tool response carries a `source` field. Responses labelled `DEMO` are
illustrative reference data, not a live feed — verify against the authority
named in the response before acting on it.
## 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)
## 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 -->