EIA MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EIA MCP Server What is the current electricity demand in the ERCOT power grid?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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 |
| Get electricity retail sales data by state and sector |
| Get power generation and fuel consumption data |
| Get real-time grid operations by balancing authority |
| Get state-level electricity profiles |
| Get generator inventory and capacity data |
| Get individual power plant data |
| Get natural gas summary data |
| Get natural gas price data |
| Get exploration and reserves data |
| Get production data |
| Get import/export and pipeline data |
| Get storage facility data |
| Get consumption data by sector |
| 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 toolseia_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
Scored across 14 tools
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.
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.
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.
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
Energy data from EIA: electricity, fuel prices, and renewables
US power plant, generation, price, curtailment and water data, with sources on every result.
Live US power market prices, load, generation, weather and permits for AI agents.
Paid Electricity Market & Grid Intelligence API via x402. Unpaid tool calls return 402.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides 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
- AlicenseNot gradedqualityDmaintenanceProvides 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
- AlicenseNot gradedqualityCmaintenanceEnables real-time access to US electricity generation, fuel mix, and demand data through natural language queries.69 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables access to US Energy Information Administration statistics including production, consumption, prices, exports, and more, with series search and natural-language queries.91 npmMIT