Skip to main content
MCP server CX Codex

eia-energy-mcp-server — Claude Code MCP server for US energy data

eia-energy-mcp-server is an MCP server for Claude Code that provides access to EIA data on electricity, petroleum, natural gas, coal, and forecasts via MCP.

no license 1,457 installs ★ 3 updated 2026-10-23

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http eia-energy-mcp-server https://eia-energy-mcp-server--cyanheads.run.tools
Open on GitHub

What eia-energy-mcp-server does

The server exposes seven tools for EIA API v2. Four core tools — eia_browse_routes (category and dataset listing), eia_describe_route (leaf route structure with facets and date range), eia_search_routes (series name and filter value lookup), eia_query_route (time series retrieval with facet filters). Three DataCanvas tools — eia_dataframe_describe, eia_dataframe_query, eia_dataframe_drop — work only when DataCanvas is enabled; it is on by default, but the Claude Desktop bundle disables it via CANVAS_PROVIDER_TYPE=none.

You need an EIA API key, passed in the EIA_API_KEY environment variable. The server runs over STDIO or HTTP; a public host is up at https://eia-energy-mcp-server--cyanheads.run.tools. Request timeout is 56 seconds, enough for retries with exponential backoff.

Tools distinguish failure types: rate_limited for quota exceeded, upstream_unreachable for connection drops, upstream_timeout when EIA does not respond. If a facet holds thousands of values (plant IDs, mine IDs), the values_query parameter filters them by substring in id, name or alias — for plantCode, a palo verde query returns two plants in one call.

What it helps with

  • Find a time series by legacy APIv1 series ID or plain-language name
  • Retrieve oil price or Henry Hub spot data with facet filters
  • Run SQL queries across multiple loaded EIA datasets
  • Inspect dataset structure: facets, frequencies, date coverage
  • Filter thousands of facet values by substring match

Example prompts for the agent

  • Find the Henry Hub spot price series in EIA and show data for the past year
  • Load electricity generation data from electricity/facility-fuel for Palo Verde plant
  • Run SQL: SELECT period, value FROM df_electricity WHERE fuelTypeDescription = 'Coal'

How to install eia-energy-mcp-server

Platform CLI: remote server

claude mcp add --transport http eia-energy-mcp-server https://eia-energy-mcp-server--cyanheads.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about eia-energy-mcp-server

How to install eia-energy-mcp-server in Claude Code?

Run claude mcp add --transport http eia-energy-mcp-server https://eia-energy-mcp-server--cyanheads.run.tools, then set the EIA_API_KEY environment variable with your EIA API key.

What does eia-energy-mcp-server do?

It provides tools to navigate the EIA dataset taxonomy, search series by name or legacy ID, retrieve time series with facet filters, and run SQL queries over staged results.

What does eia-energy-mcp-server require to work?

An EIA API key, passed in the EIA_API_KEY variable. The public host works out of the box; local npx deployment needs Node.js.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open