io.github.cyanheads/eia-energy-mcp-server MCP Server

io.github.cyanheads/eia-energy-mcp-server

Repository Registry

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.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

EIA_API_KEY
required
Free API key from api.eia.gov. Required — all requests use this as the api_key query parameter.
EIA_DATASET_TTL_SECONDS
Sliding per-dataframe TTL in seconds, extended by every query that references the dataframe.
EIA_DATAFRAME_DROP_ENABLED
Set to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Also requires CANVAS_PROVIDER_TYPE=duckdb.
EIA_CANVAS_MAX_ROWS
Cumulative 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_CAP
Facet values eia_describe_route returns per facet before truncating. Page past it with the tool's facet and values_offset inputs.
CANVAS_PROVIDER_TYPE
Set 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_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_PUBLIC_URL
Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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

io.github.cyanheads/ensembl-mcp-server

Active

Look up genes, sequences, variants, homologs, and cross-database xrefs from Ensembl REST.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/epa-mcp-server

Active

Search EPA compliance, TRI, Superfund, drinking-water, EJScreen, and AirNow data.

TypeScript

View repository →

io.github.cyanheads/eur-lex-mcp-server

Active

Search EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/eurostat-mcp-server

Active

Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/evals-mcp-server

Active

Author verifiable eval records through a draft→review→revise→submit loop with enforced graders.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/exchange-rates-mcp-server

Active

Convert currencies, get FX rates, and query historical ECB exchange rate data.

TypeScript

Apache-2.0

View repository →