Eia Energy MCP Server

@cyanheads/eia-energy-mcp-server Browse and query the U.S. Energy Information Administration API v2 - electricity, petroleum, natural gas, coal, forecasts, and more via MCP. STDIO or Streamable HTTP. Its 7 documented tools cover eia, dataframe, routes, route.

People who work with eia, dataframe and routes and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-19 · ★ 2 · #97 OF 292 MAINTAINED API INTEGRATION · VERIFIED 2026-09-30

NOASSERTION · TypeScript servers · how we verify → /methodology

01 · Install Eia Energy MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, EIA_API_KEY before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://eia-energy.caseyjhand.com/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to eia-energy.caseyjhand.com

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license no standard license detected - usage rights unclear; check the repo before commercial use

npm package @cyanheads/eia-energy-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Eia Energy MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list child routes under a path in the EIA dataset taxonomy, read a leaf route's facets, valid values, data columns, frequencies, and date range, fetch data from a leaf route with facet filters, date range, and column selection, and list active DataCanvas dataframes staged by eia_query_route, with schema and provenance.

The 7 tools it gives your agent

Extracted from the project's README - what eia-energy-mcp-server lets an agent do.

eia_browse_routes
- Lists child routes under a path in the EIA dataset taxonomy; omit path for the 14 top-level categories.
eia_describe_route
- Returns a leaf route's facets, valid values, data columns, frequencies, and date range.
eia_search_routes
- Fuzzy text search across route names, descriptions, STEO series names, and facet values.
eia_query_route
- Fetches data from a leaf route with facet filters, date range, and column selection; optionally stages results for SQL.
eia_dataframe_describe
- Lists active DataCanvas dataframes staged by eia_query_route, with schema and provenance.
eia_dataframe_query
- Runs a read-only SQL SELECT against staged DataCanvas dataframes.
eia_dataframe_drop
- Drops a DataCanvas dataframe, freeing its memory.

Latest releases

v0.4.2 · 2026-09-19

Route aliases and literal query tables · Route aliases accept route and path across browse, describe, and query without changing advertised schemas (#63) · Literal EIA and SQL table cells preserve headers and values…

v0.4.1 · 2026-08-25

mcp-ts-core 0.12 adoption - strict tool inputs, Docker hardening · @cyanheads/mcp-ts-core bumps to ^0.12.3. Tool inputs are now strict - · an undeclared top-level argument is rejected by name instead of · silently…

v0.4.0 · 2026-08-06

opt-in canvas staging, tool gating, route normalization · eia_query_route stages a canvas table only when called with stage: true, not automatically whenever a canvas is configured (#50)…

04 · Who maintains Eia Energy MCP Server

eia-energy-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

  1. obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 690
  2. mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 152
  3. git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
  4. clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 96
  5. openalex-mcp-server Access the OpenAlex academic research catalog - 270M+ publications. ★ 14
  6. mcp-ts-template TypeScript template for building MCP servers with declarative tooling, observability, and auth. ★ 152

05 · Facts

category
API integration - ranked #97 of 292 actively-maintained API integration servers as of 2026-09-30.
release cadence
10+ releases in the last 90 days (latest 2026-09-19)
registry
io.github.cyanheads/eia-energy-mcp-server (active, first published 2026-05-24 · 21 versions)
packages
npm:@cyanheads/eia-energy-mcp-server · npm:@cyanheads/eia-energy-mcp-server

06 · Eia Energy MCP Server FAQ

Is Eia Energy MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-19 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Eia Energy MCP Server do?

With this server connected, an agent can list child routes under a path in the EIA dataset taxonomy, read a leaf route's facets, valid values, data columns, frequencies, and date range, fetch data from a leaf route with facet filters, date range, and column selection, and list active DataCanvas dataframes staged by eia_query_route, with schema and provenance.

How do I install Eia Energy MCP Server?

Run `npx -y @cyanheads/eia-energy-mcp-server`. The README documents 3 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, EIA_API_KEY) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, EIA_API_KEY before connecting. You can also paste the ready-made client config above.

Does Eia Energy MCP Server require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-09-30; you can connect without credentials.

07 · Alternatives to Eia Energy MCP Server