Ratebook

The open rate engine for the electrified home — an openly licensed database of US electricity tariffs, an open-source rate-calculation engine, and an MCP server, so any app, device, or agent can answer "what will this kWh cost me, and when should I charge?"

Status: pre-release. See docs/ROADMAP.md for the plan.

Development

Python 3.12+, uv workspace with three packages: packages/ratebook (rate engine), packages/ratebook-data (data plant), packages/ratebook-mcp (MCP server).

uv sync                    # install all workspace packages + dev tools
uv run pytest              # tests
uv run ruff check .        # lint
uv run ratebook-data urdb  # download URDB bulk CSV → data/raw/, load into data/ratebook.duckdb

Related MCP server: MCP Energy Hub

License

Code is licensed under Apache-2.0. Published datasets are dedicated to the public domain under CC0-1.0. The seed corpus derives from the U.S. Utility Rate Database (CC0).