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

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