Luminus

Real-time European & UK electricity grid data via MCP. 48 tools, all free.

Tools

Generation & Prices

| Tool | Source | Description | |------|--------|-------------| | get_generation_mix | ENTSO-E | Real-time generation by fuel type (wind, solar, gas, nuclear, etc.) | | get_day_ahead_prices | ENTSO-E | Hourly spot prices (EUR/MWh) by bidding zone | | get_balancing_prices | ENTSO-E | Imbalance/settlement prices per period | | get_carbon_intensity | ENTSO-E | CO2 intensity (gCO2/kWh) from generation mix | | get_hydro_reservoir | ENTSO-E | Reservoir filling levels (MWh) for hydro countries |

Intraday & Balancing

| Tool | Source | Description | |------|--------|-------------| | get_intraday_prices | ENTSO-E | Continuous intraday market prices per bidding zone | | get_imbalance_prices | ENTSO-E | Real-time settlement/imbalance prices | | get_intraday_da_spread | Computed | Intraday minus day-ahead spread with directional signal | | get_realtime_generation | ENTSO-E / BMRS | Actual generation by fuel type (MW), 5-15 min resolution | | get_balancing_actions | ENTSO-E / BMRS | Activated balancing energy (up/down regulation volumes) |

Forecasts

| Tool | Source | Description | |------|--------|-------------| | get_renewable_forecast | ENTSO-E | Day-ahead wind & solar generation forecast (MW) | | get_demand_forecast | ENTSO-E | Day-ahead total load/demand forecast (MW) |

Gas & LNG

| Tool | Source | Description | |------|--------|-------------| | get_gas_storage | GIE AGSI+ | European gas storage levels, fill %, injection/withdrawal | | get_lng_terminals | GIE ALSI | LNG terminal inventory, send-out rates, capacity | | get_us_gas_data | EIA | US gas storage (Bcf) and Henry Hub prices (USD/MMBtu) | | get_eu_gas_price | Yahoo Finance | TTF/NBP gas prices in EUR/MWh for spark spread calculations | | get_entsog_data | ENTSOG | Gas pipeline flows, nominations, interruptions, and capacities |

BESS & Ancillary

| Tool | Source | Description | |------|--------|-------------| | get_ancillary_prices | ENTSO-E | FCR/aFRR/mFRR reserve procurement prices (EUR/MW) | | get_remit_messages | ENTSO-E | REMIT urgent market messages (forced outages, capacity reductions) | | get_price_spread_analysis | Computed | BESS arbitrage schedule with optimal charge/discharge windows | | get_regelleistung | Regelleistung.net | FCR/aFRR/mFRR tender results and procurement prices (DE + EU) | | get_acer_remit | ACER REMIT | Centralized UMMs and outage events from Inside Information Platforms |

Grid Infrastructure

| Tool | Source | Description | |------|--------|-------------| | get_cross_border_flows | ENTSO-E | Physical electricity flows between zones (MW) | | get_net_positions | ENTSO-E | Net import/export position by zone | | get_transfer_capacities | ENTSO-E | Net transfer capacity (NTC) between zones | | get_outages | ENTSO-E | Generation & transmission outages with reasons | | get_power_plants | Open Power System Data | Plant database: capacity, fuel, location, year | | get_auction_results | JAO | Cross-border capacity auction prices & allocation | | get_transmission_lines | OpenStreetMap | HV transmission line routes (220kV+) | | get_eu_frequency | mainsfrequency.com | Real-time grid frequency (Hz) and deviation |

UK Specific

| Tool | Source | Description | |------|--------|-------------| | get_uk_carbon_intensity | National Grid ESO | UK carbon intensity, index, and fuel mix | | get_uk_grid_demand | National Grid ESO | UK demand (MW) and grid frequency (Hz) | | get_elexon_bmrs | Elexon BMRS | GB imbalance prices, generation by fuel, balancing bids, system warnings |

Commodities

| Tool | Source | Description | |------|--------|-------------| | get_commodity_prices | Yahoo Finance | EUA carbon, Brent crude, TTF gas prices with 5-day history |

Regional Specialists

| Tool | Source | Description | |------|--------|-------------| | get_energy_charts | energy-charts.info | European electricity prices, generation, and flows (no API key) | | get_nordpool_prices | Nordpool | Nordic and Baltic day-ahead prices at 15-min resolution | | get_smard_data | SMARD (Bundesnetzagentur) | High-resolution German generation, consumption, and market data | | get_ember_data | EMBER Climate | Yearly power sector generation, capacity, emissions, and demand | | get_rte_france | RTE France (ODRE) | French generation (nuclear, wind, solar), consumption, and exchanges | | get_energi_data | Energi Data Service | Danish real-time CO2, production, prices, and electricity balance | | get_fingrid_data | Fingrid | Finnish grid data at 3-min resolution (generation, imports, frequency) | | get_terna_data | Terna | Italian generation, demand, exchanges, and zonal market prices | | get_ree_esios | REE ESIOS | Spanish prices, demand, generation mix, wind/solar forecast vs actual |

Hydropower

| Tool | Source | Description | |------|--------|-------------| | get_hydro_inflows | ERA5-Land (Open-Meteo) | Hydro inflow proxy for 10 European basins (precipitation, snowmelt) |

Weather & Climate

| Tool | Source | Description | |------|--------|-------------| | get_weather_forecast | Open-Meteo | Temperature, wind speed, solar radiation by location | | get_solar_irradiance | PVGIS | Monthly irradiance, optimal angle, annual PV yield | | get_era5_weather | ERA5 (Copernicus/ECMWF) | Historical reanalysis: wind at hub height, solar radiation, temperature | | get_stormglass | Storm Glass | Offshore marine weather: wind, waves, swell, sea temperature (10 req/day) |

Quick Start

npm install luminus-mcp

API Keys

Set keys via environment variables or ~/.luminus/keys.json:

# Option 1: .env file
ENTSOE_API_KEY=your-key-here        # Required for most ENTSO-E tools
GIE_API_KEY=your-key-here           # Optional: gas storage & LNG
EIA_API_KEY=your-key-here           # Optional: US gas data
FINGRID_API_KEY=your-key-here       # Optional: Finnish grid data
ESIOS_API_TOKEN=your-token-here     # Optional: Spanish market data
STORMGLASS_API_KEY=your-key-here    # Optional: offshore marine weather

// Option 2: ~/.luminus/keys.json (alternative to env vars)
{
  "ENTSOE_API_KEY": "your-key-here",
  "GIE_API_KEY": "your-key-here"
}

Key resolution order: environment variable first, then ~/.luminus/keys.json. Tools with missing keys are automatically skipped at startup (they never appear in the tool list).

All keys are free:

• ENTSO-E: Register at transparency.entsoe.eu, then email transparency@entsoe.eu
• GIE: Register at agsi.gie.eu
• EIA: Register at eia.gov/opendata
• Fingrid: Register at data.fingrid.fi
• ESIOS: Email consultasios@ree.es to request a token
• Storm Glass: Register at stormglass.io

Many tools work without any API key: energy-charts.info, ENTSOG, Elexon BMRS, RTE France, Energi Data Service, ERA5 weather, hydro inflows, Nordpool, SMARD, EMBER, and more.

Profiles

By default all 48 tools are registered. Use --profile to load only what you need, cutting context window cost by 60-90%:

npx luminus-mcp --profile trader     # 8 tools: prices, spreads, commodities
npx luminus-mcp --profile grid       # 10 tools: flows, outages, infrastructure
npx luminus-mcp --profile generation # 6 tools: gen mix, forecasts, carbon
npx luminus-mcp --profile gas        # 5 tools: storage, LNG, pipeline flows
npx luminus-mcp --profile renewables # 5 tools: wind/solar forecasts, hydro
npx luminus-mcp --profile uk         # 3 tools: UK carbon, demand, Elexon
npx luminus-mcp --profile bess       # 5 tools: arbitrage, ancillary, balancing
npx luminus-mcp --profile regional   # 9 tools: country-specific sources
npx luminus-mcp --profile weather    # 5 tools: forecasts, ERA5, marine
npx luminus-mcp --profile full       # all 48 tools (default)

Two meta-tools are always registered regardless of profile:

• luminus_discover — list available tools and profiles
• luminus_status — server health: registered tool count, active profile, configured/missing API keys

Claude Code

# Full tool set
claude mcp add luminus -- npx luminus-mcp

# With a profile (recommended for faster responses)
claude mcp add luminus -- npx luminus-mcp --profile trader

MCP Config (Claude Desktop / OpenClaw)

{
  "mcpServers": {
    "luminus": {
      "command": "npx",
      "args": ["luminus-mcp", "--profile", "trader"],
      "env": {
        "ENTSOE_API_KEY": "your-key-here"
      }
    }
  }
}

Example Queries

Ask your AI agent:

• "What's powering Germany's grid right now?"
• "Compare day-ahead prices across France, Spain, and Italy"
• "How full are Europe's gas storage facilities?"
• "Show me wind generation forecast for tomorrow in Denmark"
• "What's the carbon intensity in the UK right now?"
• "Are there any nuclear outages in France?"
• "What's the net transfer capacity between Norway and Germany?"
• "Show me gas pipeline flows through the Netherlands"
• "What are GB imbalance prices doing today?"
• "Get historical wind speeds at 100m for a North Sea offshore site"
• "What did FCR tender prices look like this week?"
• "How much is France exporting to Spain right now?"
• "What's the Danish CO2 intensity in DK1?"
• "Show Finnish wind production over the last 24 hours"
• "What are the hydro inflow conditions in Norway?"
• "Get offshore weather forecast for the Dogger Bank wind farm"
• "What's the Spanish day-ahead price curve today?"

Data Sources

| Source | Link | Coverage | |--------|------|----------| | ENTSO-E Transparency Platfo