Repository avatar
Other Tools
v0.1.13
active

nishati-mcp

io.github.gabrielmahia/nishati-mcp

Kenya energy guides: KPLC connections, tariff estimate, solar options, programmes. Illustrative.

Documentation

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

pip install nishati-mcp

Tools (6)

  • kplc_connection_guide —
    args: county, connection_type
  • tariff_calculator —
    args: monthly_units_kwh, customer_type
  • solar_options_guide —
    args: budget_kes, use_case
  • energy_subsidy_programs —
    args: county
  • energy_rights_query —
    args: topic

Live data: solar_yield_estimate

Annual and monthly output of a fixed solar system at any location, from the European Commission's PVGIS service (free, no key). Each answer names its source and retrieval time; if PVGIS does not answer, the tool returns an error instead of a number. PVGIS © European Union, 2001-2026; reuse is authorised provided the source is acknowledged. The other five tools still use DEMO data.

Example

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:

{
  "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 part of the Kenya coordination infrastructure. Connect it to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

pip install africa-coord-bus

All servers: pypi.org/user/gmahia Live demo: 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. 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.