Pjm

@pipeworx/pjm

Data Miner 2 を介した PJM Interconnection の市場データ — リアルタイム LMP、燃料種別の発電量、および米国最大の送電網運営者（13 州＋DC、約 6,500 万人、イリノイ州からニュージャージー州まで）の 7 日間の需要予測です。

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

ツール

• pjm_feeds(feed?, row_count?, start_row?) — Data Miner 2 のフィードカタログを一覧表示するか、正確な名前を指定して任意のフィード（da_hrl_lmps、inst_load、…）を取得します。ここに専用ツールがない数百の PJM フィードを利用するための手段です。
• pjm_lmp_realtime(pnode_id?, pnode_name?, datetime_beginning_ept?, row_count?) — 混雑および損失の内訳を含む、5 分ごとのリアルタイム LMP です。
• pjm_load_forecast(forecast_area?, row_count?) — 送電ゾーン別および RTO 合計の 7 日間の時間別需要予測です。
• pjm_generation_fuel_mix(fuel_type?, datetime_beginning_ept?, row_count?) — 燃料種別ごとの MW と総発電量に対する割合です。

認証

現時点では BYO のみです。 Ocp-Apim-Subscription-Key ヘッダー（Azure API Management）を使用します。プラットフォームのフォールバック環境変数 — 未設定：PLATFORM_PJM_KEY。

キーは無料ですが、https://apiportal.pjm.com/ でアカウントを登録し、さらにそのアカウントで Data Miner 2 プロダクトを購読する必要があります。この 2 つの手順が必要です。登録済みでもフィードを購読していないキーは、キーがない場合と同じように拒否されます。そのため、このパックの 401 メッセージでは単に「無効なキー」とするのではなく、購読について明示しています。

キーが設定されるまでは、すべてのツールが requires an API key を含むメッセージで拒否します。また、デプロイ時にベンダーキーのチェックで失敗しないよう、workers/gateway/src/pack-manifest.json でこのパックに byoExpected: true が設定されています。PLATFORM_PJM_KEY が設定された日に byoExpected を削除してください。

データソース

• https://dataminer2.pjm.com/ — 同じフィードを表示するブラウザー UI です。
• https://api.pjm.com/api/v1/ — API です。ドキュメントに記載されたレスポンス形式： { "totalRows": N, "items": [...], "links": [...] }。

注意事項

• ここでのレスポンス形式は未検証です。 キーがないため、このパックでは PJM のレスポンス本文をライブで確認できていません。このパックは、ドキュメントに記載された {totalRows, items, links} 形式を正規化し、items をフィールド名の変更や個別フィールドの再構成なしに公開されたまま返します。実際に試せなかったドキュメントからフィールドの対応付けを作ると、気づかれない誤回答につながる可能性があるため、これは意図的な設計です。上流の行をそのまま返すことで、実際にわかっていることを正直に示しています。キーが使えるようになり、実際のペイロードを読み取れるようになったら、これを改良してください。
• ここでの 401 からは、ほとんど何もわかりません。 2026-09-17 に検証済み：api.pjm.com は、キーなしの場合も、形式上は有効だが未登録のキーを使用した場合も、空の本文と WWW-Authenticate ヘッダーなしで 401 を返します。そのため 401 では、「キーがない」「キーが間違っている」「キーがこのフィードを購読していない」を区別できません。このパックは原因を推測せず、その旨をエラーに記載します。
• format=json はデフォルトではありません — Data Miner 2 は別の形式をデフォルトで使用します。このパックでは常にこれを設定します。
• **時刻は東部標準時（EPT — 夏時間に応じて変わります）**で、範囲フィルターには ISO-8601 ではなく、Data Miner 独自の "M/D/YYYY HH:MM to M/D/YYYY HH:MM" 形式を使用します。
• 0 行の 200 は成功ではなくエラーとして扱われます：ほとんどの場合、日付フィルターがフィードの公開期間外であることを意味します。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントがない場合：HTTP で呼び出す

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

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

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

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

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

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

npx -y @pipeworx/mcp-pjm

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

ask_pipeworx の使用

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

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

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

詳細情報

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

ライセンス

MIT