aria-mcp-elpriser

# aria-mcp-elpriser MCP server exposing Danish electricity spot prices (DK1/DK2) — keyless, open-source. Designed for use with [ARIA](https://github.com/kimhjort/aria), Kim Hjort's personal AI assistant, but works with any MCP-compatible client. ## What it does Provides four tools to fetch real-time and day-ahead Danish electricity spot prices from [elprisenligenu.dk](https://www.elprisenligenu.dk), which publishes Nord Pool spot prices sourced via Energi Data Service. **Important:** All prices are raw Nord Pool spot prices and **exclude** Danish taxes, tariffs (Energinet, network operator), and transport costs. The total consumer price on your electricity bill is significantly higher. ## Tools | Tool | Description | |------|-------------| | `get_prices` | Hourly spot prices for a date (24 entries with local Copenhagen timestamps) | | `get_current_price` | Spot price for the current hour | | `get_cheapest_hours` | The N cheapest hours for a date, sorted ascending by price | | `get_price_summary` | Min / max / avg + cheapest and most expensive hour for a date | ### `get_prices({ area?, date? })` Returns an array of 24 hourly `{ DKK_per_kWh, time_start_local, time_end_local }` entries. ### `get_current_price({ area? })` Returns the single entry covering the current Europe/Copenhagen hour. ### `get_cheapest_hours({ area?, date?, count? })` Returns the `count` cheapest hours (default 3) sorted by price ascending. Use this to advise on the best time to run the dishwasher or charge an EV. ### `get_price_summary({ area?, date? })` Returns `{ area, date, min_DKK_per_kWh, max_DKK_per_kWh, avg_DKK_per_kWh, cheapest_hour, most_expensive_hour }`. ### Common parameters - **`area`** — `"DK1"` (West Denmark, postal codes > 4999) or `"DK2"` (East Denmark). Defaults to the `DEFAULT_PRICE_AREA` env var, or `"DK2"` if not set. - **`date`** — `"today"` (default), `"tomorrow"`, or `"YYYY-MM-DD"`. ### Tomorrow's prices Tomorrow's prices are published by Nord Pool around **13:00 CET**. Before that, the API returns 404 and the tools return a clear message asking to try again later. ## Data source & attribution - **API:** [elprisenligenu.dk](https://www.elprisenligenu.dk) — free, keyless public API - **Underlying data:** Nord Pool spot prices via [Energi Data Service](https://www.energidataservice.dk/) - No API key or registration required. ## Requirements - Node.js >= 20 (uses global `fetch` and `Intl.DateTimeFormat`) ## Environment variables | Variable | Default | Description | |----------|---------|-------------| | `DEFAULT_PRICE_AREA` | `DK2` | Default price area when the `area` parameter is omitted. Set to `DK1` for West Denmark. | ## ARIA configuration Add to your ARIA `McpServers` configuration: ```json { "Name": "elpriser", "Command": "npx", "Args": ["-y", "aria-mcp-elpriser"], "Env": { "DEFAULT_PRICE_AREA": "DK2" } } ``` Omit the `Env` block to use the default (`DK2`). Set `DEFAULT_PRICE_AREA` to `DK1` if you are on West Denmark (postal codes above 4999, i.e. Jutland and Funen outside the Lillebælt bridge area). ## Development ```bash npm install npm run build npm test node dist/index.js # runs the stdio MCP server ``` ## License MIT — see [LICENSE](LICENSE).