io.github.cyanheads/eia-energy-mcp-server
v0.4.4Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:02 AM
- Latency
- 246 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Feia-energy-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/eia-energy-mcp-server": {
"url": "https://eia-energy.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
6 shown · authentication unknown
Browse EIA Routes
eia_browse_routes
Lists child routes under a given path in the EIA dataset taxonomy. Start with no path to get the 14 top-level categories (electricity, petroleum, natural-gas, steo, aeo, ieo, seds, etc.), then drill into subcategories. Each result includes an isLeaf flag — leaf routes are queryable endpoints; non-leaf routes have children to browse. When isLeaf is true on the browsed path itself, switch to eia_describe_route. The first call after server start waits up to 20s for the route tree to warm, then answers from EIA directly.
Schema valid · SHA-256 28d375785dce…
View input schema
{ "type": "object", "properties": { "path": { "description": "Route path to browse (e.g. \"electricity\", \"petroleum/pri\"). Omit for root. Whitespace and slashes are normalized, then one complete leading v2 segment is removed: \"/v2/electricity/retail-sales/\" resolves to \"electricity/retail-sales\", and \"/v2/\" to root. A path naming an EIA endpoint is refused: pass the route before its data or facet segment (\"petroleum/pri/spt\", not \"petroleum/pri/spt/data\" or \"petroleum/pri/spt/facet/series\"), and give the ID of a seriesid/{id} path to eia_search_routes. Full URLs are not normalized.", "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }Describe EIA Dataframes
eia_dataframe_describe
List canvas dataframes (df_<id>) materialized by eia_query_route calls that passed stage: true, with provenance, expiry, row count, and column schema. Nothing is staged until such a call runs, so an empty list on a fresh session means no query has staged yet, not that staging failed. Drops entries for dataframes the canvas no longer holds before responding, so the list is always current. Pass a specific name to inspect one dataframe; omit to list all active dataframes for this tenant. A name that is not staged comes back as found=false alongside the handles that are, never as an empty list. Listing is not use: only an eia_dataframe_query statement naming a dataframe extends its expiry, so a dataframe polled with this tool and never queried still lapses on schedule.
Connections
streamable-http
https://eia-energy.caseyjhand.com/mcp