Openei Urdb

@pipeworx/openei-urdb

NREL の Utility Rate Database（URDB）— 米国の電気料金：家庭用、 商業用、産業用の料金体系と、段階別および時間帯別の従量料金、 需要料金、月額固定料金、ネットメータリングの扱い、適用開始日を 電力会社の EIA ID に紐付けて提供します。

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

ツール

• urdb_search_rates(address? | latitude+longitude | utility | eia_id, sector?, detail?, approved_only?, limit?, offset?, _apiKey?) — 料金体系を検索します。
• urdb_rate_detail(label, _apiKey?) — 料金計算に必要な月別・時間別の期間スケジュール（12×24）を含む、1 つの料金体系の完全な構造を返します。
• urdb_utilities_for_location(address? | latitude+longitude | filter, _apiKey?) — 指定した場所にサービスを提供する電力会社と、料金体系の件数および現行の料金体系の件数を返します。

認証

OpenEI API では api_key が必要です。NREL の公開 DEMO_KEY は利用でき、実際のデータを返します（2026-09-17 に確認済み）。そのため、このパックはレート制限が低い状態で設定なしでも動作し、アクセス制限付きのパックではありません。

DEMO_KEY の制限を超える場合は、各自の無料 NREL キーを _apiKey として渡してください。無料キーはこちらです：https://developer.nrel.gov/signup/

プラットフォームキーは、注入される _platformKey 引数（PLATFORM_NREL_KEY）から読み取られます。パックのマニフェストで platformKeyEnv として宣言してはいけません。シークレットが実際に用意されるまでは宣言しないでください。ゲートウェイは Cloudflare の 250 個のテキストバインディング上限に達しており、シークレットがない状態でフラグを宣言すると、料金の質問が、拒否しかできないツールにルーティングされるためです。

データソース

• https://api.openei.org/utility_rates?version=latest — 料金の検索と詳細。
• https://api.openei.org/utility_companies?version=latest — 電力会社名のディレクトリ。

developer.nrel.gov/api/utility_rates/v3.json は、2026-09-17 にこちらの外向き通信から到達できませんでした（HTTP エラーではなく接続エラー）。そのため使用していません。

注意事項

以下はいずれも HTTP 200 を返します。

• radius を指定すると、緯度・経度による検索結果が黙って 0 件になります。 lat=37.5202&lon=-122.2758 だけなら PG&E の料金体系が返りますが、同じ呼び出しに &radius=25 を追加すると何も返りません。このパックでは送信しません。
• 地理情報による検索には、実際にデータがない地域があります。 Houston は緯度・経度と ZIP 77002 のどちらで検索しても料金体系が 0 件です。テキサス州の小売電力自由化に伴う料金体系は URDB にほとんど登録されていません。これはエラーではなくデータの欠落であり、ツールは何もない配列だけを返すのではなく、その旨を伝えます。
• address は上流でジオコーディングされ、一部の ZIP では機能しますが、他の ZIP では機能しません。何も返らない場合は、通常、緯度・経度または utility で検索できます。
• sector と address を組み合わせると、複数の検索結果が 0 件になりました。
• startdate／enddate はUNIX 秒単位で、URDB には更新済みの料金体系も残されています。終了日を過ぎた料金体系は過去のものです。is_active で確認でき、すべての結果が更新済みの場合はツールが警告します。

クイックスタート

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

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

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

https://gateway.pipeworx.io/openei-urdb/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/urdb_search_rates \
  -H 'Content-Type: application/json' \
  -d '{"utility":"Pacific Gas & Electric Co","sector":"Residential","limit":5}'

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

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

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

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

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

npx -y @pipeworx/mcp-openei-urdb

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Openei Urdb data" })

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

詳細

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

ライセンス

MIT