io.github.cyanheads/eia-energy-mcp-server MCP Server
io.github.cyanheads/eia-energy-mcp-server
What this kind of tool is for
- Query, inspect, or seed a database without writing a one-off script.
- Let your agent look up schema details before it writes migration code.
- Move a small dataset between tools without leaving the terminal.
How to compare servers like this
- Engine match:
- Confirm it speaks your exact database and version, not just the family.
- Access scope:
- Read-only connections are the safe default — start there before granting writes.
- Safety rails:
- Check whether destructive statements need an explicit confirmation before they run.
- Maintenance signal:
- Database drivers change; a recently updated tool is less likely to break mid-query.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.cyanheads/eia-energy-mcp-server MCP server?
Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.
How to install io.github.cyanheads/eia-energy-mcp-server
Copy-paste configuration for popular MCP clients.
EIA_API_KEYrequiredFree 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.
EIA_DATAFRAME_DROP_ENABLEDSet to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Also requires CANVAS_PROVIDER_TYPE=duckdb.
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.
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.
CANVAS_PROVIDER_TYPESet to 'duckdb' to enable DataCanvas (Node.js only). Registers the three eia_dataframe_* tools and lets eia_query_route stage rows when called with stage: true.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
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'.
{
"mcpServers": {
"eia-energy-mcp-server": {
"command": "bun",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server",
"run",
"start:stdio"
],
"env": {
"EIA_API_KEY": "<YOUR_EIA_API_KEY>",
"EIA_DATASET_TTL_SECONDS": "<YOUR_EIA_DATASET_TTL_SECONDS>",
"EIA_DATAFRAME_DROP_ENABLED": "<YOUR_EIA_DATAFRAME_DROP_ENABLED>",
"EIA_CANVAS_MAX_ROWS": "<YOUR_EIA_CANVAS_MAX_ROWS>",
"EIA_FACET_VALUE_CAP": "<YOUR_EIA_FACET_VALUE_CAP>",
"CANVAS_PROVIDER_TYPE": "<YOUR_CANVAS_PROVIDER_TYPE>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
"MCP_PUBLIC_URL": "<YOUR_MCP_PUBLIC_URL>",
"MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
}
}
}
}Related MCP servers
Look up genes, sequences, variants, homologs, and cross-database xrefs from Ensembl REST.
Search EPA compliance, TRI, Superfund, drinking-water, EJScreen, and AirNow data.
Search EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.
Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.
Author verifiable eval records through a draft→review→revise→submit loop with enforced graders.
Convert currencies, get FX rates, and query historical ECB exchange rate data.
