Miso

@pipeworx/miso

MISO（Midcontinent ISO）のリアルタイム電力データ — 燃料構成、負荷、5 分間隔の LMP、風力／太陽光の予測値と実績値、およびルイジアナ州からミネソタ州、さらに マニトバ州にまたがる 15 州の管轄区域における送電系統の拘束制約。

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

ツール

• miso_fuel_mix(period?) — 燃料カテゴリ（石炭、ガス、原子力、風力、太陽光、 水力、蓄電池、その他）別の発電量（MW）と管轄区域の合計。 current（デフォルト）＝最新の 5 分間隔、today／yesterday＝1 日全体。
• miso_lmp(region?, node?, limit?) — 価格設定ノードごとの 5 分間隔の LMP（$/MWh）。 損失および混雑の構成要素と、すべてのアンシラリーサービスの約定価格 （調整力、マイレージ、同期予備力、補助予備力、短期予備力、上げ／下げランプ）を含みます。 中部、北部、南部の各地域に約 1,600 のノードがあります。
• miso_binding_constraints(kind?) — 現在拘束中のフローゲートとそのシャドープライス。 transmission（デフォルト）、subregional または reserve。
• miso_load() — 今日の実績負荷を時間ごとに、同じ時間帯の中期負荷予測と比較したデータと、 5 分間隔の総負荷系列。
• miso_wind_solar() — 風力および太陽光の時間ごとの予測値と実績値（MW）。

認証

キー不要です。登録、キー、レート制限に関する記載はありません。

データソース

• https://public-api.misoenergy.org/ — ライブ公開 API。エンドポイント一覧は このホストのルートで HTML として表示されます。
• https://www.misoenergy.org/markets-and-operations/rtdataapis/ — これらのフィードに関する MISO 独自の ページ。

注意点

今も誰もが引用するエンドポイントは、何も返さずに成功します。 MISO が長年にわたって 文書化してきた Real-Time Data Broker —

https://api.misoenergy.org/MISORTWDDataBroker/DataBrokerServices.asmx
  ?messageType=getfuelmix&returnType=json

— は現在も名前解決でき、現在も HTTP 200 を返しますが、すべてのデータ messageType （getfuelmix、getlmpconsolidatedtable、gettotalload、…）に対して

{"error": "no data", "See": "https://www.misoenergy.org/markets-and-operations/rtdataapis"}

を返します。ペイロードを含むのは getapiversion だけです。res.ok を確認するクライアントは、 何も返さないまま永遠に成功を報告します。これは docs/silent-zero-policy.md に記載された 障害パターンです。2026-09-17 に停止を確認しました。このパックは public-api.misoenergy.org のみと通信し、misoGet は文字列 error を含む本文に対して例外を スローするため、将来サービスが終了した場合も、黙って失敗するのではなく明確に失敗します。

ほかに知っておくとよい点：

• すべての数値は文字列です。 "34168"、また /api/Snapshot の表示フィードでは "99,978" のようにカンマ区切りです。num() は値を数値に変換し、空欄には 0 ではなく null を返すため、「読み取り値なし」が「0 メガワット」として扱われることはありません。
• タイムスタンプは年間を通じて EST です。 MISO は夏時間に合わせて市場時刻を変更しません。 ペイロードにもその旨が明示されています。
• /api/FuelMix は単一のインターバルであり、系列ではありません。 1 日全体を取得するには /Today または /Yesterday を使用してください。
• MediumTermLoadForecast が使用するのは Hour ではなく HourEnding です。 すぐ隣にある ClearedMW は Hour を使用します。両方を Hour でキー指定すると、予測列がすべて null に なります。
• /api/WindSolar/GetCombined は未来の時間帯も返します。 それらの実績値は意味のある値ではなく、 欠落しています。このパックでは、まだ到来していない時間帯の実績値を null とし、 午後 11 時に風力発電量が 0 MW であるとは報告しません。
• getapiversion はネゴシエーションなしで gzip 圧縮されています。 そのため、 --compressed を指定せずに curl を実行するとバイナリが表示されます。Workers の fetch は 自動的に展開します。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントがない場合は、HTTP 経由で呼び出せます

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

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

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

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

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

起動を確認するには、直接実行する方法もあります。

npx -y @pipeworx/mcp-miso

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Miso data" })

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

詳細

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

ライセンス

MIT