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

Installation

cd eia-mcp
pip install -e .

Configuration

Get an API key from EIA Open Data
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

EIA MCP Server

EIA MCP Server

Features

Electricity Data

Natural Gas Data

Installation

Configuration

Usage with Claude Desktop

Available Tools

Example Queries

API Reference

Reviews