Iso Ne

@pipeworx/iso-ne

ISO Express ウェブサービス経由で ISO New England の市場データを取得します。ニューイングランド6州（CT、MA、ME、NH、RI、VT）の5分間隔のLMP、システム負荷、発電の燃料構成を提供します。

Pipeworx の一部です。AI エージェントを1882以上のライブデータソースにつなぐ MCP ゲートウェイです。独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれも行われていません。

ツール

• isone_lmp(location_id?, date?, limit?) — エネルギー、混雑、損失の各成分を含む、5分間隔のリアルタイム LMP です。 現在の間隔を取得するには date を省略します。
• isone_load(date?, limit?) — 5分間隔の総システム負荷（MW）です。
• isone_fuel_mix(date?, limit?) — 燃料区分（ガス、原子力、水力、風力、太陽光、廃棄物、木材、石炭、石油、埋立地ガス、輸入）別の発電量と、限界燃料フラグを取得します。

認証

現在は BYO のみです。 webservices.iso-ne.com に対する HTTP Basic 認証を使用します。プラットフォームのフォールバック環境変数は未設定です：PLATFORM_ISONE_KEY。

登録は https://www.iso-ne.com/participate/applications-status-changes/ から無料で行えます（「ISO Express / Web Services」アカウント）。ただし、認証情報が使えるようになる前に、ISO-NE によるアカウント承認が必要です。 新規登録直後は誤ったパスワードの場合とまったく同じように拒否されるため、このパックの401メッセージではパスワードが誤っていると示唆せず、承認手順について案内します。

_apiKey には、次のどちらの形式も指定できます。

• "username:password" — 平文です。パックが Base64 エンコードします。
• base64("username:password") — エンコード済みです。seo-serp と同じ規約です。

それ以外の形式では、上流の401エラーだけが表示されて障害のように見えることなく、明確なメッセージを表示してローカルで失敗します。

PLATFORM_ISONE_USER と PLATFORM_ISONE_PASS の2つではなく、環境変数は1つです。 ゲートウェイは各パックに対して、_apiKey にシークレットを1つだけ注入します。そのため、保存する認証情報は Basic 認証方式が必要とする単一の文字列です。このパックは、ベンダーキーの導入基準によってデプロイが失敗しないよう、workers/gateway/src/pack-manifest.json で byoExpected: true に設定されています。認証情報が導入されたら、この設定をすぐに削除してください。

データソース

• https://webservices.iso-ne.com/api/v1.1/ — 認証が必要な API です。 /fiveminutelmp/current、/fiveminutesystemload/current、/genfuelmix/current、および過去の日付向けの /…/day/YYYYMMDD を使用します。
• https://www.iso-ne.com/isoexpress/ — 同じデータを表示する公開ブラウザー UI です。

注意点

• キー不要のフォールバックはありません。これは推測ではなく、実際に確認済みです。 2026-09-17 に調査し、すべて拒否されました：
  • webservices.iso-ne.com/api/v1.1/fiveminutesystemload/current → 401
  • www.iso-ne.com/ws/wsclient → 500（試したすべてのパラメーター形式で発生）
  • www.iso-ne.com/transform/csv/genfuelmix?start=… → 403。ブラウザーの User-Agent と isoexpress の Referer の両方を指定しても403のままです。404ではなく403なので、パス自体は存在します。セッションによって制限されているのであり、単に UA によって制限されているのではありません（UA の差し替えで解決することが多い reference_gov_site_ua_blocks と比較してください）。
• ここでのレスポンス形式は未検証です。 アカウントを持っていないため、このパックで ISO-NE のレスポンス本文を実際に確認できていません。ISO-NE は結果を単数形／複数形のペアでラップします（{"FiveMinLmps": {"FiveMinLmp": [...]}}）。このパックでは、最初に見つかった配列値のプロパティまで汎用的にたどってラップを解除し、フィールド名を変換せずに、公開されたままの行を返します。各レスポンスの envelope フィールドには、実際にたどったキーが記録されるため、認証情報を使った最初の実行で真の形式を確認でき、形式が隠れることはありません。認証情報を取得したら、処理を厳密化してください。
• 当日分のリクエストが空になるのは正常な場合があります。 ISO-NE は各日のレポートを後から公開します。このパックでは、0件の成功をエラーとして扱い、空の配列を正常な回答として返すのではなく、前日を試すよう案内します。
• ISO-NE のドキュメントでは、.json サフィックスの使用が統一されていません。 このパックはすべてのパスに .json を付加します。これは v1.1 API が受け付ける形式です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "iso-ne": {
      "url": "https://gateway.pipeworx.io/iso-ne/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/iso-ne/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック独自のツールに加えて、共通ツールがおよそ30個表示されます。接続の initialize レスポンスに正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応していない質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。そのためにMCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックのものだけでなく、各パックのツールがすべて直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも同じゲートウェイと同じ1,882以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがなくてもHTTP経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/isone_lmp \
  -H 'Content-Type: application/json' \
  -d '{"limit":100}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/isone_lmp を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "iso-ne": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-iso-ne"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-iso-ne

stdin/stdout 経由でMCPを使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Iso Ne data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT