get_carbon_intensity
Calculate CO2 emissions per kWh of electricity generated over specified time periods to monitor energy mix cleanliness and environmental impact.
Instructions
Get carbon intensity over time (gCO2/kWh).
Calculates CO2 emissions per unit of electricity generated. Lower values indicate cleaner energy mix.
Args: start_date: Start datetime in ISO format (YYYY-MM-DDTHH:MM) end_date: End datetime in ISO format (YYYY-MM-DDTHH:MM) time_granularity: Time aggregation (raw, hour, day, fifteen_minutes)
Returns: JSON string with carbon intensity time series and statistics.
Examples: Get hourly carbon intensity for a day: >>> await get_carbon_intensity("2025-10-08T00:00", "2025-10-08T23:59", "hour")
Get daily carbon intensity for a week:
>>> await get_carbon_intensity("2025-10-01T00:00", "2025-10-07T23:59", "day")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | ||
| start_date | Yes | ||
| time_granularity | No | hour |
Input Schema (JSON Schema)
{
"properties": {
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
},
"time_granularity": {
"default": "hour",
"type": "string"
}
},
"required": [
"start_date",
"end_date"
],
"type": "object"
}