All servers · Scraping & browsing · Databases · Datasets & public data

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

io.github.cyanheads/eia-energy-mcp-server · v0.4.6

New (7 days)Tools changed (7 days)

Measured by MCP Station

Last check	Reachable
Checked at	—
Check success 7 / 30 days	—
First-try success 30 days	—
Median response	—
Lookups 30 days	—
Authentication	No auth
MCP version	2025-06-18
Rank score	—
Declared risk	Read-only (all tools declare readOnlyHint)
Capabilities declared	logging, prompts, resources, tools
Tool definitions	6 tools · with description 100% · input schema is an object 100% · read/destructive hints 100%

Description written by the publisher, not verified

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

Connect

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

claude mcp add --transport http eia-energy-mcp-server https://eia-energy.caseyjhand.com/mcp

{
  "mcpServers": {
    "eia-energy-mcp-server": {
      "url": "https://eia-energy.caseyjhand.com/mcp"
    }
  }
}

Tools as reported by the server

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

Tool changes

2026-10-24: eia_browse_routes, eia_describe_route, eia_search_routes, eia_query_route, eia_dataframe_describe, eia_dataframe_query
2026-10-23: eia_browse_routes, eia_describe_route, eia_search_routes, eia_query_route, eia_dataframe_describe, eia_dataframe_query
2026-10-16: eia_browse_routes, eia_describe_route, eia_search_routes, eia_query_route, eia_dataframe_describe, eia_dataframe_query

Repository · JSON · Text for agents · Registry updated 2026-10-23