Environment
Data source: Electricity Maps
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/electricity-maps/
claude_desktop_config.json
{
"mcpServers": {
"gnist-electricity-maps": {
"url": "https://context.gnist.ai/mcp/electricity-maps/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/electricity-maps/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_carbon_intensity", "arguments": {"zone": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/electricity-maps/
5 endpoints available:
GET /rest/electricity-maps/get_carbon_intensityGET /rest/electricity-maps/get_grid_mixGET /rest/electricity-maps/forecast_intensityGET /rest/electricity-maps/find_greenest_regionGET /rest/electricity-maps/report_feedback
Shell
curl "https://context.gnist.ai/rest/electricity-maps/get_carbon_intensity?zone=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/electricity-maps/get_carbon_intensity",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"zone": "example"
},
)
print(resp.json())
Command Line
Command
gc electricity-maps
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
get_carbon_intensityGet the carbon intensity of electricity production for a grid zone.
| Parameter | Type | Required | Description |
|---|---|---|---|
zone | string | required | Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO"). See https://app.electricitymaps.com for a full list of zone codes. |
datetime | any | optional | Optional ISO 8601 datetime string to look up historical intensity. If omitted, returns the latest available value. Historical data covers approximately the past 24 hours. |
get_grid_mixGet the current electricity production breakdown by energy source for a grid zone.
| Parameter | Type | Required | Description |
|---|---|---|---|
zone | string | required | Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO"). |
forecast_intensityGet predicted carbon intensity for a grid zone over the coming hours.
| Parameter | Type | Required | Description |
|---|---|---|---|
zone | string | required | Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO"). |
hours_ahead | integer | optional | How many hours of forecast to return (1–48, default 24). (default: 24) |
find_greenest_regionCompare carbon intensity across multiple grid zones and rank them by greenness.
| Parameter | Type | Required | Description |
|---|---|---|---|
zones | list[string] | required | List of Electricity Maps zone codes to compare (e.g. ["NO", "SE", "FI", "DE", "FR"]). |
window_hours | integer | optional | Averaging window in hours (1 = current value, default 1). Values > 1 average over recent history for a smoother signal. (default: 1) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |