zukhanyendiki9-code/eskomsepush-mcp

MCP server for EskomSePush — ask Claude about South African load shedding in plain language. # ⚡ eskomsepush-mcp > Model Context Protocol server for EskomSePush — bringing real-time South African load shedding data to Claude and any MCP-compatible AI client. Built by a South African developer, for South Africans. Ask Claude about load shedding in plain language. --- ## What it does | Tool | Description | Plan | |---|---|---| | `get_status` | Current national load shedding stage (Eskom + Cape Town) | Free ✅ | | `check_allowance` | See how many API calls you have left today | Free ✅ | | `search_areas` | Find your area ID by suburb or city name | Paid 💳 | | `get_area_schedule` | Upcoming events and full schedule for your area | Paid 💳 | | `get_areas_nearby` | Discover areas by GPS coordinates | Paid 💳 | ### Example prompts - *"What stage are we on right now?"* → works on free plan - *"How many API calls do I have left today?"* → works on free plan - *"Is there load shedding in Stellenbosch tonight?"* → paid plan - *"Show me the load shedding schedule for Sandton this week"* → paid plan - *"Find load shedding areas near me"* (with GPS) → paid plan --- ## Prerequisites - Node.js 18+ - An EskomSePush API token from eskomsepush.gumroad.com ### API Plan Requirements EskomSePush operates a tiered API. The free tier returns **HTTP 410 Gone** on area-lookup endpoints — those require a paid subscription. This MCP server exposes the full tool surface regardless of plan; unsupported tools will surface the 410 as a clear error to the client. | Plan | Cost | What works | |---|---|---| | Free | $0 via Gumroad | `get_status`, `check_allowance` | | Paid | From $55/yr | All 5 tools | --- ## Installation ### Option 1 — npx (recommended) ```bash npx eskomsepush-mcp ``` ### Option 2 — Clone & build ```bash git clone github.com cd eskomsepush-mcp npm install npm run build ``` --- ## Configuration ### Claude Desktop Add to your `claude_desktop_config.json`: **macOS:** `~/Library/Application Support/Claude/cl …