Spp

@pipeworx/spp

SPP（Southwest Power Pool）のリアルタイム電力データです。発電構成、需要、再生可能エネルギーの予測と実績、5分ごとのLMP、および2013年までさかのぼる未加工のMarketplaceファイルアーカイブを、テキサス州パンハンドルからノースダコタ州までの14州の管轄区域を対象に提供します。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続するMCPゲートウェイです。

ツール

• spp_generation_mix(limit?, detailed?) — 5分間隔ごとの燃料別MW （石炭、ガス、原子力、風力、太陽光、水力、ディーゼル燃料油、蓄電、廃熱、廃棄物処理、その他）と総需要を提供します。detailed: true にすると、過去365日間のフィードで各燃料を市場分と自己スケジュール分に分けます。
• spp_load_forecast(limit?, include_future?) — 実際の需要、風力、太陽光に対する短期・中期の需要、風力、太陽光の予測（STLF/MTLF、STWF/MTWF、STSF/MTSF）を提供します。
• spp_lmp_latest(location?, limit?) — 最も新しく公開されたRTBMの5分間隔データを、決済地点（約1,600か所）ごとに提供します。LMPはMEC／MCC／MLCに分割されます。
• spp_files(dataset, path?, download?, limit?) — 特定の過去の間隔または日付を指定して、Marketplaceファイルアーカイブを直接閲覧またはダウンロードします。

認証

キー不要です。登録も不要です。

データソース

• https://portal.spp.org/chart-api/gen-mix/asFile — 当日の発電構成CSV。
• https://portal.spp.org/chart-api/gen-mix-365/asFile — 市場分と自己スケジュール分を含む過去365日間のデータ。
• https://portal.spp.org/chart-api/load-forecast/asFile — 需要／風力／太陽光の予測と実績のCSV。
• <https://portal.spp.org/file-browser-api/?fsName=&path=&type=folder> — MarketplaceアーカイブのJSONディレクトリ一覧。
• <https://portal.spp.org/file-browser-api/download/?path=> — ファイル。

注意点

• marketplace.spp.org はすべてのAPIパスを portal.spp.org に302リダイレクトします。 Workerのフェッチがリダイレクト処理に依存しないよう、portal.spp.org を直接呼び出してください。
• 需要予測CSVは1週間先まで公開され、新しい順に並んでいます。 そのため、先頭の約2,000行はすべての値が空の未来の間隔です。単純に rows[0] を取得すると、null の行が正常な結果として返されます。2026-09-17の計測では、確定済みの287行の前に予測のみの行が2,017行ありました。spp_load_forecast は「この行にActual Loadがあるかどうか」で分割し、最新の確定済み行から latest_actual を報告するとともに、呼び出し元が内訳を確認できるよう forecast_only_intervals を公開します。生のCSVを取得するのではなく、このパックを使う主な理由です。
• 1つのデータセット内に2つのタイムゾーンがあります。 gen-mix のタイムスタンプはGMTです。LMPアーカイブのファイル名（RTBM-LMP-SL-202609171905.csv）は中部時間です。混在させると5時間または6時間ずれます。LMPファイル内では、Interval は中部時間、GMTIntervalEnd はUTCです。
• 「現在の」LMPファイル名を計算しないでください。 SPPは各5分間隔のデータを数分遅れで公開するため、現時点のファイル名は通常404になります。spp_lmp_latest は当日の By_Interval フォルダーを一覧表示し、存在する最新のファイルを取得します。深夜の中部時間直後は前日分にフォールバックします。
• ファイル一覧エンドポイントにトークンは不要です。 SPPのUIは X-SPP-UI-Token ヘッダーを送信しますが、サーバー側では不要です（2026-09-17に確認済み）。そのため、このパックはトークンを偽造せず、送信もしません。
• 空欄は不明を意味し、ゼロではありません。 num() は空のセルに対して null を返します。

クイックスタート

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

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

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

https://gateway.pipeworx.io/spp/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 も、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

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

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

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

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

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

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-spp

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

ask_pipeworx の使用

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

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

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

詳細

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

ライセンス

MIT