# Corrently Energy MCP

> Corrently Energy connects your AI client directly to real-time German energy market data. It lets you forecast green power availability, predict solar generation, and schedule high-power activities for maximum cost savings or minimum CO₂ emissions.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** renewable-energy, co2-forecasting, smart-grid, market-data, sustainability, energy-optimization

## Description

This MCP brings deep, live intelligence about the German energy grid straight into your workflow. Instead of checking multiple websites to see if charging your EV is cheap, clean, or both, you ask your agent one question. You can check current carbon intensity at any zip code using real-time readings and forecasts for emissions over time. The system also helps you create intelligent operating schedules—for heat pumps, industrial machines, or EVs—by balancing cost against solar peaks or low CO₂ days. Because this capability is built into the Vinkius catalog, you get immediate access to a full range of German energy market insights without needing specialized developer skills.

## Tools

### get_best_hour
Identifies the optimal time windows for using high-power appliances by assessing renewable availability and CO₂ levels.

### calculate_co2_offset
Calculates the compensation needed to neutralize a specified amount of CO₂ emissions for various activities.

### get_co2_meter
Displays the current, real-time carbon intensity of the local electricity grid in grams of CO₂ per kilowatt-hour.

### get_co2_prediction
Forecasts how high or low the carbon emissions will be for electricity consumption over a specified time period.

### create_energy_schedule
Generates an optimized running schedule for energy devices based on your chosen priority: price, solar power, or low emissions.

### get_dispatch
Reports on the current mix of renewable energy being fed into the grid, including contributions from wind and solar sources.

### get_gsi_prediction
Predicts the Green Power Index (GSI), indicating when clean, renewable electricity is expected to be most abundant.

### get_market_data
Retrieves current wholesale and regional market prices for electricity in a specific German location.

### get_merit_order_list
Shows the current energy generation mix, detailing which power plants are running and their cost efficiency.

### get_phev_charge_or_fuel
Provides decision support for plug-in hybrid owners on whether they should charge electrically or use fuel right now.

### get_solar_prediction
Forecasts the expected energy production output (kWh) from a specific size of solar panel installation over time.

### get_stromkonto_balance
Checks the status and balance of an electricity account, including green energy certificates.

## Prompt Examples

**Prompt:** 
```
What is the renewable energy forecast for Berlin zip code 10115 today?
```

**Response:** 
```
I've fetched the GrünstromIndex forecast for Berlin 10115. Over the next 24 hours, renewable energy availability ranges from 45% to 78%. The greenest window is between 11:00-15:00 when solar generation peaks, with GSI values reaching 72-78. CO₂ intensity during this period drops to approximately 280 g/kWh.
```

**Prompt:** 
```
When is the best 4-hour window to run my dishwasher in Munich 80331 to use the greenest energy?
```

**Response:** 
```
Analyzing the optimal window... The best 4-hour period for low-CO₂ energy in Munich 80331 is from 10:00 to 14:00. During this timeframe, solar generation is at its peak and grid CO₂ intensity drops to around 250 g/kWh. Starting your dishwasher at 10:00 AM will maximize renewable energy usage.
```

**Prompt:** 
```
Show me current electricity market prices for Hamburg 20095 and tell me when it's cheapest today.
```

**Response:** 
```
Fetching market data for Hamburg 20095... Current wholesale electricity prices range from 45 €/MWh to 120 €/MWh today. The cheapest hours are 12:00-15:00 (solar peak, ~48 €/MWh) and 02:00-05:00 overnight (~52 €/MWh). The most expensive period is 18:00-20:00 evening peak at ~115 €/MWh.
```

## Capabilities

### Schedule Appliances for Best Conditions
You can define an automated schedule for devices based on whether you prioritize the lowest cost, maximum solar input, or minimum CO₂ output.

### Check Real-Time Grid Emissions
The MCP instantly provides the current carbon intensity of electricity at any German location (g CO₂/kWh).

### Forecast Clean Power Availability
You get a Green Power Index (GSI) prediction, showing exactly when wind and solar sources are most abundant in your area.

### Predict Local Solar Output
The tool predicts how much energy a specific size of PV system will generate at your location over time.

### Determine Ideal Charging Decisions
For plug-in hybrid drivers, the MCP advises whether it makes more sense to charge electrically or use gasoline based on current market factors.

## Use Cases

### The Weekend Washing Machine Problem
A homeowner needs to run a large load of laundry but doesn't know when is best. They ask their agent: 'When should I run my washer in Munich?' The MCP uses `get_best_hour` and compares the results against `get_solar_prediction`, advising them that 10 AM for three hours maximizes clean energy use.

### The Corporate Emissions Report
A sustainability manager needs to prove carbon reduction. They ask the MCP to calculate the required compensation using `calculate_co2_offset` based on travel data, providing immediate numbers for their quarterly report.

### Optimizing Industrial Load Balancing
An industrial facility manager needs to set an operating schedule for heat pumps and machinery. They use `create_energy_schedule`, setting the mode to 'emission' to ensure operations occur during periods of lowest grid CO₂.

### Hybrid Car Dilemma
A user asks if they should charge their plug-in hybrid car now. The MCP uses `get_phev_charge_or_fuel` and determines that, given current market prices and high solar input, charging is the superior choice.

## Benefits

- Avoid paying high prices. By checking `get_market_data`, you know exactly when wholesale electricity costs dip, letting you schedule heavy loads for the cheapest hours.
- Reduce your carbon footprint without effort. Use `get_co2_prediction` to see which days and times are cleanest, helping you align appliance use with low-emission periods.
- Maximize self-generated power. Running a schedule using `create_energy_schedule` ensures appliances run when the solar forecast from `get_solar_prediction` is at its peak.
- Improve EV charging strategy. The MCP advises via `get_best_hour`, telling you precisely when to charge your vehicle for maximum green energy benefit or minimum cost.
- Understand grid stability. You can check `get_dispatch` and the `get_merit_order_list` to see exactly which sources (wind, gas, etc.) are currently powering the region.

## How It Works

The bottom line is you get actionable insights into when and how to use power based on live grid conditions, without having to manually consult multiple utility dashboards.

1. Subscribe to this MCP in Vinkius.
2. (Optional) Enter your Corrently API token for higher rate limits, though many data endpoints work without credentials.
3. Ask your AI client a question—like 'What's the best time to run my washer?'—and it queries the German energy market data.

## Frequently Asked Questions

**Do I need an API token to use the Corrently Energy MCP server?**
No! Most Corrently API endpoints work without authentication. An optional token is only needed if you want higher rate limits for heavy usage. Simply subscribe to the server and start querying energy data immediately.

**What German zip codes are supported for energy forecasts?**
All German Postleitzahl (PLZ) 5-digit zip codes are supported — from 01067 (Dresden) to 80331 (Munich). Simply provide any valid German zip code and the API will return localized energy forecasts for that region's grid area.

**Can I use this MCP server to optimize when I charge my electric vehicle?**
Absolutely! Use the `get_best_hour` tool to find optimal charging windows based on renewable energy availability or lowest CO₂ emissions. Then use `create_energy_schedule` to generate a full optimized charging plan. You can also use `get_phev_charge_or_fuel` if you drive a plug-in hybrid and need advice on whether to charge electrically or use fuel.

**How accurate are the solar generation predictions for my photovoltaic system?**
The `get_solar_prediction` tool provides forecasts based on weather models and your system's kWp capacity. Accuracy depends on location, panel orientation, and weather conditions. It's best used for relative comparisons (e.g., "Will tomorrow be sunnier than today?") rather than absolute precision. For typical home systems (5-10 kWp), day-ahead forecasts are generally within 15-25% of actual generation.

**When should I use `get_co2_meter` versus `get_co2_prediction`?**
Use `get_co2_meter` for real-time carbon readings, giving you instant data on grid cleanliness right now. If you want to understand how emissions are expected to change over several hours, use `get_co2_prediction`.

**How does `create_energy_schedule` decide between 'price' and 'emission' modes?**
The mode defines the optimization priority. Setting it to 'price' targets the lowest cost electricity, while setting it to 'emission' ensures your schedule uses power with the fewest associated carbon emissions.

**What does `get_merit_order_list` tell me about the energy grid?**
This function shows you a real-time breakdown of which power plants are active and how they rank in terms of cost efficiency. It gives a clear view of the entire current energy generation mix.

**What specific details can I get using `get_stromkonto_balance`?**
This tool checks your electricity account status, providing more than just cash balances. You'll see information on any accumulated green energy certificates or credits you own.