Eia Energy MCP server

online · 100% uptime

by cyanheads·io.github.cyanheads/eia-energy-mcp-server·v0.5.1·2 stars

No reviews yet

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

A86/100grade A

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

A86/100

not scanned yet

Adoption

Growing

2 stars556 downloads/wk

Reviews

Write one

Nobody has reviewed Eia Energy yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Eia Energy tools

Tool list not cached yet. `describe` through the gateway fetches it live.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Eia Energy compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 86/100; higher than 72% of 48,255 servers
Uptime: 100%; of our recent checks; the typical remote server answers 100%
Response time: 229 ms; faster than 59% of 30,031 servers
GitHub stars: 2; more than 75% of 28,688 servers
Downloads a week: 556; more than 89% of 12,191 servers with a package

Release history: 7 versions in the registry since 2026-08-25, latest 2026-11-04, typically one every 10 days.

Install Eia Energy in Claude Code, Cursor or VS Code

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

Add to Cursor

What the publisher says

From the Eia Energy repository's README, as published. We do not edit it. Read it on GitHub

@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. 4 core tools + 3 DataCanvas tools

Public Hosted Server: https://eia-energy.caseyjhand.com/mcp

Overview

Energy data from the U.S. Energy Information Administration (EIA) API v2 — electricity, petroleum, natural gas, coal, and forecasts. Browse the dataset taxonomy, search it by natural language, and query time-series data with facet filters, then stage large result sets as a SQL-queryable DataCanvas table. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

The three eiadataframe tools are registered only when CANVASPROVIDERTYPE=duckdb is set; eiadataframedrop additionally requires EIADATAFRAMEDROP_ENABLED=true. A default deployment lists the first four tools.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Eia Energy: common questions

Is Eia Energy MCP server safe?: Yes, by our scan: it is graded A (86/100). Read the Eia Energy safety report
How do I install Eia Energy?: It runs remotely at eia-energy.caseyjhand.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Eia Energy need an API key?: No secret keys are declared. It reads 22 settings from the environment.
Is Eia Energy maintained?: The last commit was 22 days ago (2026-10-12). The latest release is v0.5.1.
Is Eia Energy up?: 100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does Eia Energy compare with other MCP servers?: safety score 86/100 (higher than 72% of 48,255 servers); uptime 100% (of our recent checks; the typical remote server answers 100%); response time 229 ms (faster than 59% of 30,031 servers). Full comparison.

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call io.github.cyanheads/eia-energy-mcp-server → <tool>

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: A · 86/100
Stars: 2
Downloads/wk: 556
Price: Free
Licence: NOASSERTION
Transport: Remote · mixed
Uptime: 100% · 28/28 checks
Version: 0.5.1
Category: Everything else
Last release: 2026-10-12

Credentials it needs

EIA_API_KEYFree API key from api.eia.gov. Required — all requests use this as the api_key query parameter.
EIA_DATASET_TTL_SECONDSSliding per-dataframe TTL in seconds, extended by every query that references the dataframe. At most 31536000 (365 days).
EIA_DATAFRAME_DROP_ENABLEDSet to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Has no effect with CANVAS_PROVIDER_TYPE=none.
EIA_CANVAS_MAX_ROWSCumulative row ceiling for eia_query_route DataCanvas staging on a stage: true call. Five requests at EIA's 5000-row-per-request ceiling. At most 250000.
EIA_FACET_VALUE_CAPFacet values eia_describe_route returns per facet before truncating. Page past it with the tool's facet and values_offset inputs, or narrow a facet with values_query. At most 1000.
EIA_CLAMP_LIMITSLower an over-cap eia_query_route length, eia_dataframe_query row_limit or preview, or eia_search_routes limit to its cap with a notice. 'false' advertises and enforces each cap as a schema maximum instead.
CANVAS_PROVIDER_TYPEDataCanvas provider. 'duckdb', the default, registers eia_dataframe_describe and eia_dataframe_query and lets eia_query_route stage rows when called with stage: true; eia_dataframe_drop also requires EIA_DATAFRAME_DROP_ENABLED=true. 'none' disables DataCanvas.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPESelects the HTTP transport.
EIA_API_KEYFree API key from api.eia.gov. Required — all requests use this as the api_key query parameter.
EIA_DATASET_TTL_SECONDSSliding per-dataframe TTL in seconds, extended by every query that references the dataframe. At most 31536000 (365 days).
EIA_DATAFRAME_DROP_ENABLEDSet to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Has no effect with CANVAS_PROVIDER_TYPE=none.
EIA_CANVAS_MAX_ROWSCumulative row ceiling for eia_query_route DataCanvas staging on a stage: true call. Five requests at EIA's 5000-row-per-request ceiling. At most 250000.
EIA_FACET_VALUE_CAPFacet values eia_describe_route returns per facet before truncating. Page past it with the tool's facet and values_offset inputs, or narrow a facet with values_query. At most 1000.
EIA_CLAMP_LIMITSLower an over-cap eia_query_route length, eia_dataframe_query row_limit or preview, or eia_search_routes limit to its cap with a notice. 'false' advertises and enforces each cap as a schema maximum instead.
CANVAS_PROVIDER_TYPEDataCanvas provider. 'duckdb', the default, registers eia_dataframe_describe and eia_dataframe_query and lets eia_query_route stage rows when called with stage: true; eia_dataframe_drop also requires EIA_DATAFRAME_DROP_ENABLED=true. 'none' disables DataCanvas.
MCP_HTTP_HOSTThe hostname for the HTTP server.
MCP_HTTP_PORTThe port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
MCP_PUBLIC_URLPublic origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).
MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Endpoint

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

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/cyanheads-eia-energy-mcp-server.svg)](https://mcp.market/server/cyanheads-eia-energy-mcp-server)

How the badge works