chrismbori/kplc-mcp

MCP server for Kenya Power (KPLC) tariffs and bill calculation # kplc-mcp **MCP server for Kenya Power (KPLC) tariffs and bill calculation.** Companion to egauge-mcp. When Claude has live consumption data from your eGauge meter and KPLC tariff math from this server, it can verify a KPLC bill, predict next month's bill, and compare what you'd pay on different connection tiers. ``` You: "We're at 12 MWh and 480 kVA peak last month on CI1. Would dropping to SC2 save us anything? And what's the bill at current tariffs?" Claude: [calls calculate_bill(CI1, 12000, 480) → calculate_bill(SC2, 12000, 480) → compare_tariffs(12000, 480)] "On CI1 (11kV) you'd bill at KES 285,640. SC2 (3-phase LV) would be KES 343,580 — KES 57,940 more, even though SC2 has a lower demand rate, because CI1's energy rate is KES 1.19/kWh cheaper. CI2 (33kV) would be cheapest at KES 264,440 if you can justify the 33kV connection cost." ``` ## Tools - `list_customer_categories` — every KPLC category with full tariff structure - `get_current_tariff` — schedule for one category (DC, SC1, SC2, CI1-CI5, SL) - `calculate_bill` — full bill from kWh + kVA peak (with override-able pass-throughs) - `compare_tariffs` — bill under every applicable category, ranked cheapest first ## Customer categories | Code | Description | |------|-------------| | DC | Domestic (≤100A single-phase) | | SC1 | Small Commercial (≤100A) | | SC2 | Small Commercial (3-phase, 415V, >100A, ≤1MVA) | | CI1 | Commercial/Industrial 11kV | | CI2 | Commercial/Industrial 33kV | | CI3 | Commercial/Industrial 66kV | | CI4 | Commercial/Industrial 132kV | | CI5 | Commercial/Industrial 220kV | | SL | Street Lighting | ## Install ```bash uvx --from git+github.com kplc-mcp ``` ## Connect to Claude ### Claude Desktop / Claude Code ```json { "mcpServers": { "kplc": { "command": "uvx", "args": ["--from", "git+github.com", "kplc-mcp"] } } } ``` ## Tariff currency All amounts in KES. Tariffs are based on the EPRA RTAR 2023 review a …