eia_series
ActiveTool of Eia
declared in 0.1.0
Search EIA for any energy data series by route path. Returns historical data points with timestamps and values. Use for specific energy metrics not covered by category tools.(e.g., "petroleum/pri/gnd" for gasoline prices, "natural-gas/pri/sum" for gas prices, "electricity/retail-sales" for electricity, "total-energy/data" for total energy). Returns time series with period, value, and metadata.
Parameters schema
{
"type": "object",
"examples": [
{
"route": "petroleum/pri/gnd",
"_apiKey": "your-eia-api-key"
},
{
"limit": 52,
"route": "natural-gas/pri/sum",
"start": "2023-01",
"_apiKey": "your-eia-api-key",
"frequency": "weekly"
}
],
"required": [
"_apiKey",
"route"
],
"properties": {
"end": {
"type": "string",
"description": "End date (optional)"
},
"limit": {
"type": "number",
"description": "Max records to return (default: 12, max: 5000)"
},
"route": {
"type": "string",
"description": "EIA data route path. Common routes: \"petroleum/pri/gnd\" (gasoline/diesel prices), \"petroleum/pri/spt\" (crude oil spot prices), \"petroleum/stoc/wstk\" (petroleum stocks), \"petroleum/sum/sndw\" (petroleum supply/demand weekly), \"natural-gas/pri/sum\" (natural gas prices), \"natural-gas/stor/sum\" (natural gas storage), \"electricity/retail-sales\" (electricity sales/prices), \"total-energy/data\" (total energy overview), \"coal/shipments\" (coal data)"
},
"start": {
"type": "string",
"description": "Start date, e.g., \"2023-01\" for monthly, \"2023\" for annual (optional)"
},
"_apiKey": {
"type": "string",
"description": "EIA API key (free from eia.gov)"
},
"frequency": {
"type": "string",
"description": "Data frequency: \"weekly\", \"monthly\", \"quarterly\", \"annual\" (optional)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Eia
https://github.com/pipeworx-io/mcp-eia
1/7 registries