Skip to main content
Glama

MCP Energy Server

by ebarros23
GitHub
Python
MIT License
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

⚡ MCP Energy Server

Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server that provides access to comprehensive energy data from the U.S. Energy Information Administration (EIA) API.

🚀 Quick Start: See QUICKSTART.md to get running in 5 minutes!

📋 Table of Contents

Features

This MCP server provides access to:

  • Electricity Data: Generation, consumption, sales, and revenue data by state and sector

  • Natural Gas Data: Production, consumption, prices, and storage information

  • Petroleum Data: Production, consumption, imports, exports, prices, and stock levels

  • Coal Data: Production, consumption, and pricing data

  • Renewable Energy Data: Solar, wind, hydro, geothermal, and biomass generation

  • CO2 Emissions: Emissions data by state and sector

  • STEO Forecasts: Short-Term Energy Outlook projections

  • International Data: Global energy statistics

Installation

From GitHub

# Clone the repository git clone https://github.com/YOUR_USERNAME/mcp-energy.git cd mcp-energy # Install dependencies pip install -e .

From PyPI (when published)

pip install mcp-energy

Configuration

Using with Claude Desktop

Add this to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "energy": { "command": "python", "args": ["-m", "server"], "cwd": "/path/to/mcp-energy" } } }

Using with Other MCP Clients

The server can be started directly:

python server.py

It communicates via standard input/output using the MCP protocol.

Deployment Options

Option 1: MCP Server (Local/Desktop)

Run as a Model Context Protocol server for Claude Desktop:

python server.py

See QUICKSTART.md for setup instructions.

Option 2: Web API (Cloud Deployment)

Deploy as a REST API on platforms like Render.com:

Quick Deploy to Render.com:

  1. Push code to GitHub

  2. Connect GitHub repo to Render.com

  3. Deploy with one click!

See RENDER_DEPLOYMENT.md for complete instructions.

Run Web Server Locally:

python server_web.py # API available at http://localhost:10000 # Interactive docs at http://localhost:10000/docs

Web API Features:

  • 🌐 REST API with JSON responses

  • 📊 Interactive API documentation (Swagger UI)

  • 🔄 CORS enabled for web applications

  • 💚 Health check endpoint

  • 🚀 Easy cloud deployment

For complete API documentation, see API_DOCUMENTATION.md

Available Tools

1. get_electricity_data

Get electricity generation, consumption, sales, or revenue data.

Parameters:

  • frequency: "monthly", "quarterly", or "annual" (default: "monthly")

  • data_type: "generation", "consumption", "sales", or "revenue" (default: "generation")

  • facets: Optional filters (e.g., {"stateid": ["CA"], "sectorid": ["RES"]})

Example:

{ "frequency": "monthly", "data_type": "generation", "facets": { "stateid": ["CA", "TX"], "sectorid": ["RES"] } }

2. get_natural_gas_data

Get natural gas production, consumption, prices, or storage data.

Parameters:

  • frequency: "monthly", "quarterly", or "annual" (default: "monthly")

  • data_type: "production", "consumption", "prices", or "storage" (default: "consumption")

  • facets: Optional filters

3. get_petroleum_data

Get petroleum production, consumption, imports, exports, prices, or stock data.

Parameters:

  • frequency: "weekly", "monthly", "quarterly", or "annual" (default: "monthly")

  • data_type: "production", "consumption", "imports", "exports", "prices", or "stocks" (default: "production")

  • facets: Optional filters

4. get_coal_data

Get coal production, consumption, or price data.

Parameters:

  • frequency: "monthly", "quarterly", or "annual" (default: "quarterly")

  • data_type: "production", "consumption", or "prices" (default: "production")

  • facets: Optional filters

5. get_renewable_data

Get renewable energy generation data.

Parameters:

  • frequency: "monthly", "quarterly", or "annual" (default: "monthly")

  • energy_source: "solar", "wind", "hydro", "geothermal", "biomass", or "all" (default: "all")

  • facets: Optional filters

6. get_co2_emissions_data

Get CO2 emissions data by state and sector.

Parameters:

  • frequency: "monthly" or "annual" (default: "annual")

  • facets: Optional filters

7. get_steo_data

Get Short-Term Energy Outlook forecast data.

Parameters:

  • frequency: "monthly" (default: "monthly")

  • facets: Optional filters

8. get_international_energy_data

Get international energy statistics.

Parameters:

  • frequency: "annual" (default: "annual")

  • country: Country code or name

  • facets: Optional filters

Usage Examples

Example 1: Get California Electricity Generation

Can you show me the latest monthly electricity generation data for California?

Example 2: Compare Natural Gas Prices

Compare natural gas prices between different states for the last quarter.

Example 3: Renewable Energy Trends

What are the solar energy generation trends in the US over the past year?

Example 4: CO2 Emissions Analysis

Show me the annual CO2 emissions data by sector for the most recent year available.

Development

Running Tests

pip install -e ".[dev]" pytest

Code Formatting

black . ruff check .

API Documentation

For more information about the EIA API and available data:

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and questions:

  • Create an issue on GitHub

  • Check the EIA API documentation for data availability

Changelog

Version 0.1.0 (Initial Release)

  • Basic EIA API integration

  • Support for electricity, natural gas, petroleum, coal, renewable, CO2, STEO, and international data

  • MCP protocol implementation

  • Claude Desktop integration

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

  1. 📋 Table of Contents
    1. Features
      1. Installation
        1. From GitHub
        2. From PyPI (when published)
      2. Configuration
        1. Using with Claude Desktop
        2. Using with Other MCP Clients
      3. Deployment Options
        1. Option 1: MCP Server (Local/Desktop)
        2. Option 2: Web API (Cloud Deployment)
      4. Available Tools
        1. 1. get_electricity_data
        2. 2. get_natural_gas_data
        3. 3. get_petroleum_data
        4. 4. get_coal_data
        5. 5. get_renewable_data
        6. 6. get_co2_emissions_data
        7. 7. get_steo_data
        8. 8. get_international_energy_data
      5. Usage Examples
        1. Example 1: Get California Electricity Generation
        2. Example 2: Compare Natural Gas Prices
        3. Example 3: Renewable Energy Trends
        4. Example 4: CO2 Emissions Analysis
      6. Development
        1. Running Tests
        2. Code Formatting
      7. API Documentation
        1. License
          1. Contributing
            1. Support
              1. Changelog
                1. Version 0.1.0 (Initial Release)

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ebarros23/mcp-energy'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server