Finance

Data source: hvakosterstrommen.no

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/hvakosterstrommen/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-hvakosterstrommen": {
      "url": "https://context.gnist.ai/mcp/hvakosterstrommen/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/hvakosterstrommen/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_current_electricity_price", "arguments": {"zone": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/hvakosterstrommen/

7 endpoints available:

GET /rest/hvakosterstrommen/get_current_electricity_price
GET /rest/hvakosterstrommen/get_electricity_prices_today
GET /rest/hvakosterstrommen/get_electricity_prices_tomorrow
GET /rest/hvakosterstrommen/get_cheapest_electricity_window
GET /rest/hvakosterstrommen/get_electricity_price_history
GET /rest/hvakosterstrommen/get_electricity_zone_for_location
GET /rest/hvakosterstrommen/report_feedback

Shell

curl "https://context.gnist.ai/rest/hvakosterstrommen/get_current_electricity_price?zone=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/hvakosterstrommen/get_current_electricity_price",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "zone": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc hvakosterstrommen

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (7)

get_current_electricity_price

Get the current hour's spot electricity price for a Nordpool price zone.

Parameter	Type	Required	Description
`zone`	`string`	required	Nordpool price zone (e.g. 'NO1' for Oslo/East Norway). Valid zones: NO1, NO2, NO3, NO4, NO5, SE1, SE2, SE3, SE4, DK1, DK2, FI.

get_electricity_prices_today

Get all 24 hourly electricity spot prices for today in a Nordpool price zone.

Parameter	Type	Required	Description
`zone`	`string`	required	Nordpool price zone (e.g. 'NO1' for Oslo/East Norway). Valid zones: NO1, NO2, NO3, NO4, NO5, SE1, SE2, SE3, SE4, DK1, DK2, FI.

get_electricity_prices_tomorrow

Get day-ahead electricity spot prices for tomorrow in a Nordpool price zone.

Parameter	Type	Required	Description
`zone`	`string`	required	Nordpool price zone (e.g. 'NO1' for Oslo/East Norway). Valid zones: NO1, NO2, NO3, NO4, NO5, SE1, SE2, SE3, SE4, DK1, DK2, FI.

get_cheapest_electricity_window

Find the cheapest consecutive block of hours for electricity across today and tomorrow.

Parameter	Type	Required	Description
`zone`	`string`	required	Nordpool price zone (e.g. 'NO1'). Valid zones: NO1–NO5, SE1–SE4, DK1–DK2, FI.
`duration_hours`	`integer`	required	Number of consecutive hours needed (1–24).
`not_before`	`any`	optional	ISO 8601 datetime — only consider hours at or after this time (e.g. '2026-03-13T22:00:00+01:00').
`not_after`	`any`	optional	ISO 8601 datetime — only consider hours ending at or before this time (e.g. '2026-03-14T07:00:00+01:00').

get_electricity_price_history

Get historical hourly electricity spot prices for the past N days.

Parameter	Type	Required	Description
`zone`	`string`	required	Nordpool price zone (e.g. 'NO1'). Valid zones: NO1–NO5, SE1–SE4, DK1–DK2, FI.
`days`	`integer`	optional	Number of past days to include (1–30, default 7). (default: 7)