{
  "markdown": "# Voltcast MCP Server — European electricity prices, forecasts & carbon\n\n[Model Context Protocol](https://modelcontextprotocol.io) server for\n[Voltcast](https://voltcast.com): day-ahead electricity prices for 47 European\nbidding zones (15-minute native resolution, history to 2015), probabilistic\nprice forecasts whose accuracy is published daily at\n[voltcast.com/accuracy](https://voltcast.com/accuracy), carbon intensity, and\ncheapest-window optimization.\n\nTwo ways to run it:\n\n## 1. Hosted endpoint (recommended)\n\n```\nhttps://voltcast.com/api/mcp\n```\n\nStreamable HTTP transport, protocol `2025-06-18`. Server card:\n[`/.well-known/mcp.json`](https://voltcast.com/.well-known/mcp.json).\n\n## 2. Local stdio server (this repo)\n\n```bash\nVOLTCAST_API_KEY=your_key npx voltcast-mcp\n```\n\nOr with Docker:\n\n```bash\ndocker build -t voltcast-mcp .\ndocker run -i -e VOLTCAST_API_KEY=your_key voltcast-mcp\n```\n\nThe stdio server is a thin proxy onto the same REST API — identical tools,\nauth and rate limits. It starts and answers introspection without a key;\n`list_zones` works keyless too.\n\n```json\n{\n  \"mcpServers\": {\n    \"voltcast\": {\n      \"command\": \"npx\",\n      \"args\": [\"voltcast-mcp\"],\n      \"env\": { \"VOLTCAST_API_KEY\": \"YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Auth | What it does |\n|---|---|---|\n| `list_zones` | none | The zone registry (codes, names, currencies) |\n| `get_prices` | key | Day-ahead prices for a zone/date at native market intervals |\n| `get_forecast` | key | P50 on Home/Starter and P10/P90 on Pro+ |\n| `get_carbon` | key | Carbon intensity + green score from the live generation mix |\n| `get_renewables` | key | Wind/solar forecasts (TSO + Voltcast model) vs realized |\n| `cheapest_window` | Pro+ key | Cheapest contiguous window for a load in the next 48h |\n\n## Auth\n\n`Authorization: Bearer <api key>`. New accounts start with\n[Home](https://voltcast.com/register?plan=home&utm_source=github&utm_medium=mcp-repository&utm_campaign=home-mcp&task=ai-assistant)\nat €9/month after a 7-day card-required trial; existing Free accounts remain\ngrandfathered. `list_zones` works without a key. The exact hosted-connector\nwalkthrough is at\n[voltcast.com/ai/local-electricity-price](https://voltcast.com/ai/local-electricity-price?utm_source=github&utm_medium=mcp-repository&utm_campaign=ai-assistant).\n\n## Client config\n\n```json\n{\n  \"mcpServers\": {\n    \"voltcast\": {\n      \"url\": \"https://voltcast.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n## Honesty, stated plainly\n\nEvery forecast the server returns is benchmarked daily against a naive\nbaseline in public — losses included. Zones where the model loses are free\nto use under the guarantee. Data sources: ENTSO-E Transparency Platform,\nSMARD.de (CC BY 4.0), attributed in every response.\n",
  "bytes": 2809,
  "sha": "3ca53bede71cfb70f9cdaf0765e41806969a0e28f3bc09fb7bc0edf8d2d2ed6c",
  "repo_slug": "voltcast-com/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_voltcast_voltcast_9543df5b/readme"
}