voltcast

Voltcast MCP Server — European electricity prices, forecasts & carbon

Model Context Protocol server for Voltcast: day-ahead electricity prices for 47 European bidding zones (15-minute native resolution, history to 2015), probabilistic price forecasts whose accuracy is published daily at voltcast.com/accuracy, carbon intensity, and cheapest-window optimization.

Two ways to run it:

1. Hosted endpoint (recommended)

https://voltcast.com/api/mcp

Streamable HTTP transport, protocol 2025-06-18. Server card: /.well-known/mcp.json.

2. Local stdio server (this repo)

VOLTCAST_API_KEY=your_key npx voltcast-mcp

Or with Docker:

docker build -t voltcast-mcp .
docker run -i -e VOLTCAST_API_KEY=your_key voltcast-mcp

The stdio server is a thin proxy onto the same REST API — identical tools, auth and rate limits. It starts and answers introspection without a key; list_zones works keyless too.

{
  "mcpServers": {
    "voltcast": {
      "command": "npx",
      "args": ["voltcast-mcp"],
      "env": { "VOLTCAST_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Tools

Tool	Auth	What it does
list_zones	none	The zone registry (codes, names, currencies)
get_prices	key	Day-ahead prices for a zone/date at native market intervals
get_forecast	key	P50 on Home/Starter and P10/P90 on Pro+
get_carbon	key	Carbon intensity + green score from the live generation mix
get_renewables	key	Wind/solar forecasts (TSO + Voltcast model) vs realized
cheapest_window	Pro+ key	Cheapest contiguous window for a load in the next 48h

Auth

Authorization: Bearer <api key>. New accounts start with Home at €9/month after a 7-day card-required trial; existing Free accounts remain grandfathered. list_zones works without a key. The exact hosted-connector walkthrough is at voltcast.com/ai/local-electricity-price.

Client config

{
  "mcpServers": {
    "voltcast": {
      "url": "https://voltcast.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Honesty, stated plainly

Every forecast the server returns is benchmarked daily against a naive baseline in public — losses included. Zones where the model loses are free to use under the guarantee. Data sources: ENTSO-E Transparency Platform, SMARD.de (CC BY 4.0), attributed in every response.