MCP Server MCP

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

By github 👁 1 views ▲ 0 votes

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

Homepage Verified source GitHub

Install

npx -y @cyanheads/[email protected]

Configuration Example

{
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://eia-energy.caseyjhand.com/mcp"
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@cyanheads/eia-energy-mcp-server",
      "version": "0.4.0",
      "runtimeHint": "bun",
      "transport": {
        "type": "stdio"
      },
      "packageArguments": [
        {
          "value": "run",
          "type": "positional"
        },
        {
          "value": "start:stdio",
          "type": "positional"
        }
      ],
      "environmentVariables": [
        {
          "description": "Free API key from api.eia.gov. Required — all requests use this as the api_key query parameter.",
          "isRequired": true,
          "format": "string",
          "name": "EIA_API_KEY"
        },
        {
          "description": "Sliding per-dataframe TTL in seconds, extended by every query that references the dataframe.",
          "format": "string",
          "default": "86400",
          "name": "EIA_DATASET_TTL_SECONDS"
        },
        {
          "description": "Set to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Also requires CANVAS_PROVIDER_TYPE=duckdb.",
          "format": "string",
          "default": "false",
          "name": "EIA_DATAFRAME_DROP_ENABLED"
        },
        {
          "description": "Cumulative row ceiling for eia_query_route DataCanvas staging on a stage: true call. Five requests at EIA's 5000-row-per-request ceiling.",
          "format": "string",
          "default": "25000",
          "name": "EIA_CANVAS_MAX_ROWS"
        },
        {
          "description": "Facet values eia_describe_route returns per facet before truncating. Page past it with the tool's facet and values_offset inputs.",
          "format": "string",
          "default": "50",
          "name": "EIA_FACET_VALUE_CAP"
        },
        {
          "description": "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.",
          "format": "string",
          "name": "CANVAS_PROVIDER_TYPE"
        },
        {
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
          "format": "string",
          "default": "info",
          "name": "MCP_LOG_LEVEL"
        }
      ]
    },
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@cyanheads/eia-energy-mcp-server",
      "version": "0.4.0",
      "runtimeHint": "bun",
      "transport": {
        "type": "streamable-http",
        "url": "http://localhost:3010/mcp"
      },
      "packageArguments": [
        {
          "value": "run",
          "type": "positional"
        },
        {
          "value": "start:http",
          "type": "positional"
        }
      ],
      "environmentVariables": [
        {
          "description": "Free API key from api.eia.gov. Required — all requests use this as the api_key query parameter.",
          "isRequired": true,
          "format": "string",
          "name": "EIA_API_KEY"
        },
        {
          "description": "Sliding per-dataframe TTL in seconds, extended by every query that references the dataframe.",
          "format": "string",
          "default": "86400",
          "name": "EIA_DATASET_TTL_SECONDS"
        },
        {
          "description": "Set to 'true' to expose eia_dataframe_drop for manual canvas cleanup. Also requires CANVAS_PROVIDER_TYPE=duckdb.",
          "format": "string",
          "default": "false",
          "name": "EIA_DATAFRAME_DROP_ENABLED"
        },
        {
          "description": "Cumulative row ceiling for eia_query_route DataCanvas staging on a stage: true call. Five requests at EIA's 5000-row-per-request ceiling.",
          "format": "string",
          "default": "25000",
          "name": "EIA_CANVAS_MAX_ROWS"
        },
        {
          "description": "Facet values eia_describe_route returns per facet before truncating. Page past it with the tool's facet and values_offset inputs.",
          "format": "string",
          "default": "50",
          "name": "EIA_FACET_VALUE_CAP"
        },
        {
          "description": "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.",
          "format": "string",
          "name": "CANVAS_PROVIDER_TYPE"
        },
        {
          "description": "The hostname for the HTTP server.",
          "format": "string",
          "default": "127.0.0.1",
          "name": "MCP_HTTP_HOST"
        },
        {
          "description": "The port to run the HTTP server on.",
          "format": "string",
          "default": "3010",
          "name": "MCP_HTTP_PORT"
        },
        {
          "description": "The endpoint path for the MCP server.",
          "format": "string",
          "default": "/mcp",
          "name": "MCP_HTTP_ENDPOINT_PATH"
        },
        {
          "description": "Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
          "format": "string",
          "name": "MCP_PUBLIC_URL"
        },
        {
          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
          "format": "string",
          "default": "none",
          "name": "MCP_AUTH_MODE"
        },
        {
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
          "format": "string",
          "default": "info",
          "name": "MCP_LOG_LEVEL"
        }
      ]
    }
  ]
}

mcp model-context-protocol streamable-http npm