Skip to content
MCP server

Eia Energy MCP Server

Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.6.0
Listing updated
4 days ago

About Eia Energy MCP Server

Eia Energy MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://eia-energy.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "eia-energy-mcp-server": {
      "url": "https://eia-energy.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "eia-energy-mcp-server": {
      "type": "http",
      "url": "https://eia-energy.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "eia-energy-mcp-server": {
      "serverUrl": "https://eia-energy.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "eia-energy-mcp-server": {
      "type": "http",
      "url": "https://eia-energy.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • EIA_API_KEYFree API key from api.eia.gov. Required — all requests use this as the api_key query parameter.Required
  • 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.Required
  • 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').

Pricing

Open source

Eia Energy MCP Server FAQ

Is Eia Energy MCP Server free?

Yes. Eia Energy MCP Server is open source, so you can use and self-host it for free.

How do I add Eia Energy MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http eia-energy-mcp-server https://eia-energy.caseyjhand.com/mcp