# ElectricityMap MCP

> ElectricityMap gives your AI agent real-time and forecasted data on global electricity carbon intensity and power mix. Track the carbon footprint of energy use in over 200 regions, see where power comes from (solar, wind, coal), and plan high-demand operations for times when the grid is cleanest.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** carbon-tracking, sustainability, renewable-energy, grid-monitoring, green-it

## Description

This MCP connects your AI agent to global grid transparency data. You can track how much carbon electricity generates right now, check historical trends over years, or forecast future intensity levels in specific zones. Need to schedule a large data processing job? Check the 24-hour forecasts to run it when wind and solar production are at their peak, minimizing your project's carbon footprint automatically. You can also get a full power breakdown, showing exactly what mix of energy—like gas, nuclear, or renewables—is powering any given area. If you're building complex systems, Vinkius makes sure this data feeds seamlessly into your workflow from any MCP-compatible client.

## Tools

### get_carbon_intensity_forecast
Predicts what the carbon intensity will be in a specific zone over a set time period.

### get_carbon_intensity_history
Retrieves all recorded carbon intensity data for a specified zone and date range.

### get_carbon_intensity_latest
Gets the immediate, current carbon intensity reading for any given zone.

### list_zones
Returns a complete list of every geographical area that can be queried for data.

### get_marginal_carbon_intensity_latest
Provides the most up-to-date carbon intensity reading based on the marginal power source currently running.

### get_power_breakdown_forecast
Forecasts how electricity generation will be mixed (e.g., wind, solar) in a zone over time.

### get_power_breakdown_history
Provides historical data showing the mix of energy sources that powered a zone on past dates.

### get_power_breakdown_latest
Shows the current breakdown percentage of all power sources contributing to electricity in a zone.

## Prompt Examples

**Prompt:** 
```
What is the current carbon intensity in France (FR)?
```

**Response:** 
```
I've checked the latest data for France (FR). The current carbon intensity is 45 gCO2eq/kWh, which is quite low due to high nuclear and wind production.
```

**Prompt:** 
```
Show me the power breakdown for zone DK-DK1 right now.
```

**Response:** 
```
The power breakdown for DK-DK1 shows that 65% of electricity is currently coming from wind, 15% from solar, and the rest from biomass and imports.
```

**Prompt:** 
```
What is the forecasted carbon intensity for Germany (DE) for the next few hours?
```

**Response:** 
```
The forecast for Germany (DE) indicates that carbon intensity will drop from 350 to 280 gCO2eq/kWh over the next 4 hours as solar production increases.
```

## Capabilities

### Check current carbon intensity
Retrieves the latest metric showing how much CO2 is emitted per unit of electricity for a specific zone.

### Forecast future carbon emissions
Predicts the expected carbon intensity hours or days in advance, allowing you to plan energy-intensive tasks around cleaner grid periods.

### Analyze past energy footprints
Queries historical data to audit a zone's energy usage and associated carbon output over defined time ranges.

### See power generation sources
Details the current or forecasted percentage breakdown of electricity coming from various sources like wind, solar, or coal.

### Identify supported geographic zones
Lists all available geographical areas and their metadata so you know exactly where to run a query.

## Use Cases

### Optimizing data processing jobs
A software engineer needs to run millions of simulations. Instead of running the job randomly, they ask their agent to check get_carbon_intensity_forecast for the next 48 hours and schedule the job only for periods where solar production is highest.

### Auditing corporate travel impact
A sustainability officer needs to prove carbon reduction across global offices. They use get_carbon_intensity_history to compare a region's energy mix from last year versus this quarter, generating verifiable proof of improvement.

### Real-time operational monitoring
An operations team needs immediate status on a facility in a foreign zone. They use get_power_breakdown_latest to instantly know if the grid is currently reliant on gas, or if clean power sources are active.

### Market entry planning
A data analyst is scoping out new markets and needs energy risk assessment. They check get_marginal_carbon_intensity_latest to understand the immediate carbon impact of simply turning on a grid in that zone.

## Benefits

- Automate compliance reporting by using get_carbon_intensity_history to audit a zone’s energy usage over years, giving you clear documentation for sustainability reports.
- Schedule compute-heavy jobs intelligently. Use get_carbon_intensity_forecast to identify the next few hours when solar and wind power are expected to peak, saving you money and carbon.
- Instantly see where power is coming from. The get_power_breakdown_latest tool gives immediate visibility into whether a zone is running on coal or clean renewables.
- Plan for the future with confidence. Forecasts using get_carbon_intensity_forecast let you commit to timelines knowing exactly when the carbon intensity will drop below your target threshold.
- Avoid guessing which areas are covered. Run list_zones first to confirm all available geographical zones, ensuring your AI agent never fails due to a missing coordinate.

## How It Works

The bottom line is that you ask a question about energy, and your AI client gets an immediate, detailed answer based on global grid data.

1. Subscribe to the ElectricityMap MCP and enter your API key.
2. Tell your AI client which zone or GPS coordinate you need data for (e.g., 'France').
3. The agent calls the appropriate tool, and you get back precise carbon intensity figures, power breakdowns, or historical trends.

## Frequently Asked Questions

**How far out can I forecast using get_carbon_intensity_forecast?**
The tool provides 24-hour forecasts for carbon intensity. This allows you to plan energy consumption spikes knowing precisely when the grid is predicted to be cleanest.

**Can ElectricityMap tell me what power sources are currently active in a zone?**
Yes, use get_power_breakdown_latest. This tool gives you an immediate percentage split of all generating sources, like solar, wind, and gas.

**Do I need to know the exact coordinates for every query?**
No. While precise GPS coordinates work, you can also list supported zones first using list_zones to find a general regional code that works with most queries.

**What is the difference between get_carbon_intensity_latest and get_marginal_carbon_intensity_latest?**
The latest carbon intensity gives the overall zone reading. The marginal tool specifically reports the carbon impact based on which source was needed most recently to keep the lights on.

**Can I check historical power mix data for a specific date?**
Absolutely. Call get_power_breakdown_history, and you can input specific dates to see exactly how different sources were contributing to the grid at that time.