ISO New England Power Grid

MCP Server for the NE Power Grid

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jasonkholden-ne_power_grid_mcp_server": {
      "command": "python",
      "args": [
        "/path/to/your/iso_newengland_mcp_server/run_mcp_server.py"
      ],
      "env": {
        "ISO_NE_PASSWORD": "your_iso_ne_password",
        "ISO_NE_USERNAME": "your_iso_ne_username"
      }
    }
  }
}

This MCP Server provides a standardized interface to fetch ISO New England grid information for use by AI models. It authenticates with ISO Express and exposes current and contextual grid data so you can query real-time fuel mix and related metrics to inform decisions or answer questions in your intelligent applications.

How to use

You connect to this MCP Server from an MCP client to retrieve up-to-date data about the New England power grid. Use the available tools to ask for the current marginal fuel or the complete fuel mix, then incorporate those results into your models or decision-making prompts.

How to install

Prerequisites: you need Python installed on your system and access to ISO Express to obtain credentials.

pip install -r requirements.txt

Configuration and usage notes

Configure your credentials by creating an environment file and then run the MCP server using Python. The server runs as a local process and communicates via JSON-RPC over standard I/O, so you can connect it to your MCP client.

cp .env.example .env

# Edit the following with your actual ISO Express credentials
ISO_NE_USERNAME=your_iso_express_username
ISO_NE_PASSWORD=your_iso_express_password

Run and test the server

Start the server directly or via the main module, then verify functionality with a test run.

python run_mcp_server.py

python main.py

python test_mcp_tools.py

MCP client configuration example

Use the following configuration in your MCP client to connect to this ISO New England MCP Server. It runs the server as a local process via Python and provides the required environment variables.

{
  "mcpServers": {
    "iso_newengland": {
      "command": "python",
      "args": ["/path/to/your/iso_newengland_mcp_server/run_mcp_server.py"],
      "env": {
        "ISO_NE_USERNAME": "your_iso_ne_username",
        "ISO_NE_PASSWORD": "your_iso_ne_password"
      }
    }
  }
}

Available tools

get_marginal_fuel

Returns the current marginal fuel types for the New England power grid, indicating which fuel will be used if additional power is needed right now.

get_full_fuel_mix

Returns the complete current generation fuel mix for New England, including generation amounts in megawatts and which fuels are marginal.