Public releaseYou are viewing an early public release. Original launch date: 18 May 2026. Please email hello@energymap.in for questions, issues, or feature requests.
energyatlas

Two packages. One grid.

Orchestration layer · Apache-2.0

ies-ingest

IES v0.4 contract types, canonical state and DISCOM lists, atlas-hour clock, and source-health envelopes. Fork it into your DISCOM and it becomes your IES pipeline.

pip install ies-ingest

60-second Delhi demo

terminal
# Install
pip install ies-ingest

# Run the Delhi end-to-end demo
python -c "
from ies_ingest.examples.one_state import run
run(state='DL', fy='FY2024-25')
"
# → prints demand rows, validates IES contract types, exports artefacts

Fork into your DISCOM

terminal
# Fork the pipeline into your DISCOM
git clone https://github.com/India-Energy-Atlas/ies-ingest
cd ies-ingest

# Point at your MDMS endpoint
export IES_SOURCE_URL=https://scada.your-discom.in/api/demand
make verify   # runs full E2E + prints IES-conformant output

Consumer client · MIT

india-energy-atlas

Thin async REST client over tools.energymap.in/v1/*. Auth, tariffs, grid demand, DER registries, verifiable credentials — all in one import.

pip install india-energy-atlas
auth
from india_energy_atlas import Client

# Get a free key at energymap.in/ies/get-api-key
client = Client(api_key="your-key")
fetch tariff
# Fetch tariff structure for a DISCOM
tariff = client.tariffs.get(discom="BRPL", category="LT-2A")
print(f"Fixed: ₹{tariff.fixed_charge_per_kw}/kW  Variable: ₹{tariff.variable_charge}/kWh")
list DERs on feeder
# List DERs on a feeder
ders = client.registry.list_ders(feeder="urn:in:feeder:DL-DEMO-001")
for d in ders:
    print(d.urn, d.capacity_kw, d.type)
issue credential
# Issue a Consumer Energy Passport (W3C VC 2.0)
vc = client.credentials.issue_passport(
    connection_urn="urn:in:connection:DL-CONN-7281"
)
vc.save("consumer-energy-passport.json")

MCP server

energymap-mcp

Connect Claude Desktop, Cursor, or Antigravity to the India Energy Stack. Ask questions about grid demand, carbon intensity, tariffs, and DER registries in plain English.

install
uvx energymap-mcp
claude_desktop_config.json
// claude_desktop_config.json  (or Cursor / Antigravity equivalent)
{
  "mcpServers": {
    "energymap": {
      "command": "uvx",
      "args": ["energymap-mcp"],
      "env": { "ENERGYMAP_API_KEY": "<your-key>" }
    }
  }
}

First API call needs a key

Free for institutional use. One work email. Instant access.