Connect-MCP

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

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

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

MCPremotelocal · npmno credentialsScience & open dataDatabases

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 6 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

A 100/100

What it does: 6 tools · 6 read, 0 write · Databases, Weather, Files & storage

Test call eia_browse_routes: worked (1,146 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: +20
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://eia-energy.caseyjhand.com/mcp
Package
registry:   npm
identifier: @cyanheads/eia-energy-mcp-server
version:    0.4.4
transport:  stdio

Tools

6 tools listed at last check
  • 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

Badge

Connect-MCP badge for io.github.cyanheads/eia-energy-mcp-server

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.cyanheads/eia-energy-mcp-server.svg)](https://clawy.uk/mcp/s/io.github.cyanheads/eia-energy-mcp-server)

Repository