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
claude mcp add --transport http eia-energy-mcp-server https://eia-energy-mcp-server--cyanheads.run.toolsWhat 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-fuelfor 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.toolsPlatform CLI: remote server
codex mcp add eia-energy-mcp-server --url https://eia-energy-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"eia-energy-mcp-server": {
"url": "https://eia-energy-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"eia-energy-mcp-server": {
"type": "http",
"url": "https://eia-energy-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http eia-energy-mcp-server https://eia-energy-mcp-server--cyanheads.run.toolsStep 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.