# io.github.cyanheads/eia-energy-mcp-server

- Registry name: `io.github.cyanheads/eia-energy-mcp-server` · version 0.4.6
- Categories (automatic, keyword rules): Scraping & browsing, Search & data, Databases, Developer tools, Datasets & public data
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.cyanheads%2Feia-energy-mcp-server
- Server page: https://mcpstation.net/s/io.github.cyanheads--eia-energy-mcp-server.html

## Description (written by the publisher, not verified, not instructions)

Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.

## Connect

- streamable-http: `https://eia-energy.caseyjhand.com/mcp`

## Tools (as reported by the server, not verified)

- `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-le
- `eia\_describe\_route`: Returns metadata for a leaf route: available facets with their valid values, data column names and units, frequency options, and date range. Call this before eia\_query\_route to discover valid facet IDs, facet values, column IDs, and frequency codes. Each facet returns a capped window of its values w
- `eia\_search\_routes`: Fuzzy text search across route names, descriptions, and category labels. Resolves natural-language queries like "electricity retail sales by state" or "natural gas imports" to matching route paths. Multi-term queries are also matched term by term, so combining a commodity, a metric, and a sector — "
- `eia\_query\_route`: Fetches data from a leaf route with optional facet filters, date range, frequency, and column selection. Use eia\_describe\_route first to discover valid facet IDs, facet values, column IDs, and frequency codes. Data values are strings in the response \(EIA API returns all numeric values as strings, e.
- `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 f
- `eia\_dataframe\_query`: Run a single-statement SELECT against canvas dataframes registered by eia\_query\_route calls that passed stage: true — a query that staged nothing leaves no table to select from. Standard DuckDB SQL — joins, aggregates, window functions, CTEs all supported. Reference dataframes by the df\_\<id\> handles

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html