Metadata-Version: 2.4
Name: eia-mcp-gridsense
Version: 0.1.0
Summary: MCP server exposing US electricity grid data (fuel mix, demand, retail prices, CO2 emissions) from the EIA API
Project-URL: Repository, https://github.com/pranavbhosale25/eia-mcp-gridsense
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Requires-Dist: python-dotenv>=1.0
Description-Content-Type: text/markdown

# eia-mcp-gridsense

An MCP server exposing US electricity grid data from the [EIA API](https://www.eia.gov/opendata/):

- `get_fuel_mix` — hourly generation by fuel source for a grid region
- `get_electricity_demand` — hourly demand for a grid region
- `get_wholesale_prices` — monthly retail price proxy for a state
- `get_co2_emissions` — annual CO2 emissions by state, electric power sector

## Setup

Requires an EIA API key: https://www.eia.gov/opendata/register.php

Set it as an environment variable (or in a local `.env` file, never committed):

```
EIA_API_KEY=your-key-here
```

## Usage with Claude Desktop

```json
{
  "mcpServers": {
    "eia-mcp-gridsense": {
      "command": "uvx",
      "args": ["eia-mcp-gridsense"],
      "env": {
        "EIA_API_KEY": "your-key-here"
      }
    }
  }
}
```

<!-- mcp-name: io.github.pranavbhosale25/eia-mcp-gridsense -->
