Skip to main content
Glama
EIA MCP Server

EIA MCP Server

by zen-tradings

EIA MCP Server

An MCP (Model Context Protocol) server for the U.S. Energy Information Administration (EIA) API, providing access to electricity and natural gas data.

Features

Electricity Data

  • Retail Sales - Sales to customers by state and sector, pricing, and customer counts

  • Operational Data - Monthly/annual generation, fuel consumption, and emissions

  • RTO Data - Hourly/daily operations by balancing authority (CISO, PJM, MISO, ERCOT, etc.)

  • State Profiles - State-level electricity profiles and infrastructure data

  • Generator Capacity - Inventory of operable generators in the U.S.

  • Facility Fuel - Individual power plant operational data

Natural Gas Data

  • Summary - Overview of natural gas survey data

  • Prices - Spot prices, futures, citygate, residential, commercial, industrial prices

  • Exploration & Reserves - Resource discovery and stockpile levels

  • Production - Output metrics and production volumes

  • Imports/Exports - Cross-border flows and pipeline movement data

  • Storage - Inventory levels, injections, and withdrawals

  • Consumption - End use data by sector

Related MCP server: mcp-server-eia

Installation

cd eia-mcp
pip install -e .

Configuration

  1. Get an API key from EIA Open Data

  2. Set the environment variable:

    export EIA_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "eia": {
      "command": "python",
      "args": ["-m", "eia_mcp.server"],
      "cwd": "/Users/yanpan/eia-mcp",
      "env": {
        "EIA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if installed as a package:

{
  "mcpServers": {
    "eia": {
      "command": "eia-mcp",
      "env": {
        "EIA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Tool

Description

eia_electricity_retail_sales

Get electricity retail sales data by state and sector

eia_electricity_operational_data

Get power generation and fuel consumption data

eia_electricity_rto

Get real-time grid operations by balancing authority

eia_electricity_state_profiles

Get state-level electricity profiles

eia_electricity_generator_capacity

Get generator inventory and capacity data

eia_electricity_facility_fuel

Get individual power plant data

eia_natural_gas_summary

Get natural gas summary data

eia_natural_gas_prices

Get natural gas price data

eia_natural_gas_exploration_reserves

Get exploration and reserves data

eia_natural_gas_production

Get production data

eia_natural_gas_imports_exports

Get import/export and pipeline data

eia_natural_gas_storage

Get storage facility data

eia_natural_gas_consumption

Get consumption data by sector

eia_explore_routes

Explore available API routes and metadata

Example Queries

Just ask Claude naturally:

  • "What were California's electricity retail sales in 2024?"

  • "Show me the current electricity generation in ERCOT"

  • "What are the natural gas storage levels this week?"

  • "How much electricity did Texas generate last month?"

  • "Compare natural gas prices across different regions"

  • "What's the electricity demand in PJM right now?"

  • "Show me natural gas import/export data for 2024"

API Reference

Base URL: https://api.eia.gov/v2/

For full API documentation, visit: https://www.eia.gov/opendata/documentation.php

Available Tools

14 tools
eia_electricity_facility_fuelC

Get annual and monthly operational data for individual power plants by energy source and equipment type. Source: Form EIA-923

Inputs: state, plant_id, fuel_type, frequency, +4 more.

eia_electricity_generator_capacityC

Get inventory of operable generators in the U.S. including capacity, technology type, and status. Sources: Forms EIA-860, EIA-860M

Inputs: state, status, technology, energy_source, +4 more.

eia_electricity_operational_dataB

Get monthly and annual electric power operational data including generation, fuel consumption, and emissions by state, sector, and energy source. Source: Form EIA-923

Inputs: state, fuel_type, frequency, start, +3 more.

eia_electricity_retail_salesC

Get electricity retail sales data including sales to customers by state and sector, customer counts, and pricing. Sources: Forms EIA-826, EIA-861, EIA-861M

Inputs: state, sector, frequency, start, +3 more.

eia_electricity_rtoC

Get hourly and daily electric power operations by balancing authority (Regional Transmission Operator). Includes demand, generation, and interchange data. Source: Form EIA-930

Inputs: route, respondent, fuel_type, start, +3 more.

eia_electricity_state_profilesB

Get state-level electricity profiles including generation mix, consumption patterns, and infrastructure data.

Inputs: route, state, start, end, +1 more.

eia_explore_routesB

Explore available EIA API routes and their metadata. Use this to discover available data series, facets, and parameters for any endpoint.

Inputs: path (required).

eia_natural_gas_consumptionC

Get natural gas consumption and end use data including demand patterns by sector (residential, commercial, industrial, electric power).

Inputs: route, area, sector, frequency, +4 more.

eia_natural_gas_exploration_reservesC

Get natural gas exploration and reserves data including resource discovery and stockpile levels.

Inputs: route, area, frequency, start, +2 more.

eia_natural_gas_imports_exportsC

Get natural gas imports, exports, and pipeline movement data including cross-border flows and distribution infrastructure.

Inputs: route, area, country, frequency, +4 more.

eia_natural_gas_pricesC

Get natural gas price data including spot prices, futures, citygate prices, residential, commercial, and industrial prices.

Inputs: route, area, product, frequency, +4 more.

eia_natural_gas_productionC

Get natural gas production data including output metrics and production volumes.

Inputs: route, area, product, frequency, +4 more.

eia_natural_gas_storageC

Get natural gas storage data including inventory levels, injections, and withdrawals from storage facilities.

Inputs: route, area, frequency, start, +3 more.

eia_natural_gas_summaryC

Get natural gas summary data providing an overview of the natural gas survey information.

Inputs: series, frequency, start, end, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific EIA data categories like electricity facility fuel, generator capacity, retail sales, natural gas consumption, production, prices, etc. The descriptions specify unique data sources and metrics, with no overlapping functionality that would cause agent confusion.

    Naming Consistency5/5

    All tools follow a consistent eia_domain_data_pattern naming convention (e.g., eia_electricity_facility_fuel, eia_natural_gas_prices). The structure is uniform with domain (electricity/natural_gas) and specific data type clearly separated by underscores, making the set highly predictable and readable.

    Tool Count5/5

    With 14 tools, this is well-scoped for an EIA data server covering electricity and natural gas domains. Each tool earns its place by addressing distinct data facets (e.g., capacity, sales, prices, storage), avoiding bloat while providing comprehensive access to key EIA datasets.

    Completeness5/5

    The tool surface offers complete coverage for electricity and natural gas data, including operational data, capacity, sales, RTO operations, state profiles, consumption, production, prices, storage, imports/exports, reserves, and an exploration tool. No obvious gaps exist; agents can perform full data retrieval workflows across these domains.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides access to comprehensive U.S. and international energy data from the EIA API, including electricity, natural gas, petroleum, coal, renewables, CO2 emissions, and energy forecasts.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with structured access to the U.S. EIA Open Data API for energy data including power plants, operations, fuel prices, projections, and state CO2 emissions.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables real-time access to US electricity generation, fuel mix, and demand data through natural language queries.
      69 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables access to US Energy Information Administration statistics including production, consumption, prices, exports, and more, with series search and natural-language queries.
      91 npm
      MIT