aria-mcp-elpriser

MCP server exposing Danish electricity spot prices (DK1/DK2) — keyless, open-source.

Designed for use with 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, 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 — free, keyless public API
• Underlying data: Nord Pool spot prices via Energi Data Service
• 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:

{
  "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

npm install
npm run build
npm test
node dist/index.js   # runs the stdio MCP server

License

MIT — see LICENSE.