Prospector Labs Energy

Prospector Energy MCP Server

AI エージェントが Prospector Labs Energy Data API にアクセスできるようにする MCP（Model Context Protocol）サーバーです。マイルストーン追跡機能付きの米国の系統接続キュープロジェクト、分散型発電設備、開発事業者のプロフィールと実績、ITC/PTC 税額控除の計算、ITC 案件のソーシングを利用できます。

件数は毎日変動するため、ここには掲載していません。最新の対象件数は get_queue_stats、get_dg_stats、get_developer_stats を呼び出すか、https://api.prospectorlabs.io/catalog をご覧ください。

クイックスタート

MCP クライアントに以下を追加してください。このパッケージでは本番 API の URL がデフォルトで設定されているため、環境変数は必要ありません。

{
  "mcpServers": {
    "prospector-energy": {
      "command": "uvx",
      "args": ["prospector-energy-mcp"]
    }
  }
}

まずは 1 行で API を試せます。

curl https://api.prospectorlabs.io/stats

セルフサービスで無料の API キーを約 30 秒で取得できます：https://api.prospectorlabs.io/start

利用可能なツール（32 個）

Tier 列は、https://api.prospectorlabs.io/plans に掲載されている、各ツールに必要なプランです。これは機能を示すものであり、価格ではありません。リクエストごとの行数上限と月間クエリ数の上限がありますが、バルクエクスポートを除くすべてのツールを無料で利用できます。

プロジェクトと検索

ツール	説明	Tier
search_projects	州、ISO、種類、開発事業者、容量で大規模発電プロジェクトを検索	Free
get_project	すべての拡充フィールドを含むプロジェクトの詳細情報	Free
get_project_score	プロジェクトの投資適格性スコアの内訳	Free
get_queue_stats	系統接続キューの集計統計	Free
get_milestone_summary	マイルストーンと建設段階の統計	Free
export_projects	プロジェクトの CSV 一括エクスポート	Access

案件と投資

ツール	説明	Tier
find_itc_deals	スコアリング付きの ITC 適格投資機会	Free
get_itc_deal	ITC 案件の詳細プロフィール	Free
get_itc_summary	ITC 案件パイプラインの集計統計	Free
get_investable_projects	事前審査済みの投資可能なプロジェクトと評価	Free
get_investable_summary	投資適格性の集計統計	Free
get_deal_sheet	1 ページにまとめた案件シート（HTML、印刷して PDF 化可能）	Free

税額控除

ツール	説明	Tier
calculate_tax_credits	IRA のすべての加算要件を含む ITC/PTC 適格性	Free
check_domestic_content	国内製造要件に基づく ITC ボーナス（+10%）の適格性	Free

開発事業者

ツール	説明	Tier
search_developers	名前で開発事業者のプロフィールを検索	Free
get_developer	実績を含む開発事業者の詳細プロフィール	Free
get_developer_projects	特定の開発事業者によるすべてのプロジェクト	Free
get_developer_stats	開発事業者の集計統計	Free

市場データ

ツール	説明	Tier
get_lmp_monthly	LMP の月次平均推移	Free
get_lmp_zones	利用可能な LMP 価格ゾーンの一覧	Free
get_capacity_prices	容量市場のオークション価格	Free
get_fuel_prices	州別・種類別の燃料価格	Free
get_technology_costs	NREL ATB のコスト予測	Free

系統インフラ

ツール	説明	Tier
get_grid_turbines	米国の風力タービン（USWTDB）	Free
get_grid_transmission	送電線（HIFLD）	Free
get_grid_substations	変電所（HIFLD）	Free
get_generators	EIA の発電機インベントリ	Free

分散型発電

ツール	説明	Tier
search_dg_projects	分散型発電設備を検索	Free
get_dg_stats	DG の集計統計	Free
get_investable_dg_projects	事前審査済みの投資可能な DG プロジェクト	Free
get_dg_investable_summary	投資可能な DG の集計統計	Free

ユーティリティ

ツール	説明	ティア
get_pricing	プランのティア、およびMPPを有効にしてセルフホストする場合の呼び出しごとの金額	Free

v0.4.1 の新機能

• 本番 API がデフォルトのベース URL になりました — https://api.prospectorlabs.io。以前のバージョンでは Railway のホスト名がデフォルトだったため、これ以降 PROSPECTOR_API_URL 環境変数は不要です。
• 2つのツールを掲載対象から外しました — get_lmp_daily と get_rto_generation は、背後のパイプラインにデータがないため、空の結果セットを返していました。掲載されていて常に空のツールより、存在しないツールのほうが適切です。データが利用可能になり次第、再び掲載します。
• ティアは価格ではなく機能を示します — ツールの表を /plans で公開しているプランに合わせました。以下のプランと支払いをご覧ください。

セットアップ

Claude Desktop

{
  "mcpServers": {
    "prospector-energy": {
      "command": "uvx",
      "args": ["prospector-energy-mcp"]
    }
  }
}

Claude Code

.mcp.json に追加します：

{
  "mcpServers": {
    "prospector-energy": {
      "command": "uvx",
      "args": ["prospector-energy-mcp"]
    }
  }
}

Cursor

Cursor の「設定」>「MCP サーバー」に追加します：

{
  "prospector-energy": {
    "command": "uvx",
    "args": ["prospector-energy-mcp"]
  }
}

直接インストール

# From PyPI
pip install prospector-energy-mcp

# With payment support
pip install prospector-energy-mcp[payments]

# Or with uv
uvx prospector-energy-mcp

設定

環境変数	説明	デフォルト
PROSPECTOR_API_URL	API のベース URL	https://api.prospectorlabs.io
PROSPECTOR_API_KEY	API キー。export_projects には必須です。キーがない場合は 401 が返されます。現時点では、ほかのツールでは任意です	なし
MPP_RECIPIENT_ADDRESS	支払いを受け取るウォレットアドレス（MPP を有効化。セルフホストの場合のみ）	なし（支払いは無効）
MPP_SECRET_KEY	支払いチャレンジの検証に使用する HMAC シークレット	自動生成
MPP_REALM	支払いチャレンジ用のサーバーレルム	prospectorlabs.io

https://api.prospectorlabs.io/start でキーを取得してください。

プランと支払い

プラン

プランはこのパッケージではなく、API によって公開および適用されます。最新の一覧は https://api.prospectorlabs.io/plans を呼び出して確認してください。これが唯一の正式な情報源です。

ティア	利用できる内容
Free	全列の幅、リクエストごとの行数上限、月ごとのクエリ枠。一括エクスポートは利用できません
Access	日次キュー全体 — すべてのプロジェクト、列、市場を REST と MCP の両方で利用できます。一括 CSV エクスポートも含まれます
Enterprise	一括配信、データウェアハウス共有、SLA、および自社で収集したレコードの再配布

Access と Enterprise の料金は案件ごとに設定されます — [email protected]。

エージェントによる支払い（MPP）

このサーバーでは、独自のインスタンスを実行する運用者向けに、Machine Payments Protocol（MPP）を介してツール呼び出しごとに USDC を請求することもできます。

MPP はオプトイン方式で、デフォルトでは無効です。MPP_RECIPIENT_ADDRESS が未設定の場合、paid_tool はツールをラップせずに返し、支払いチャレンジは発行されません。公開パッケージ prospector-energy-mcp は呼び出しごとの料金を請求しません — アクセスは API キーのプランによって決まります。運用者が MPP を有効にした場合の呼び出しごとの金額は、src/prospector_energy/payments.py で設定します。

有効にすると、次のように処理されます：

1. エージェントが有料ツールを呼び出します（例：search_projects）
2. サーバーが支払いチャレンジを返します（HTTP 402 相当）
3. エージェントが Tempo ブロックチェーン上で USDC を支払います
4. サーバーが支払いを検証し、データを返します
5. 無料ツール（統計、要約）は常に支払いなしで利用できます

AgentCash

このサーバーは AgentCash にも掲載されています。

クエリの例

接続後、AI エージェントに次のように尋ねてください：

• 「ERCOT のキューにある太陽光発電プロジェクトはいくつですか？」
• 「ウェストバージニア州にある 2MW の太陽光発電プロジェクトの税額控除を計算してください」
• 「ニュージャージー州で、控除率が 50% を超える投資可能な ITC 案件を探してください」
• 「開発事業者 NextEra Energy の実績について教えてください」
• 「今年の PJM の月間平均 LMP はいくらでしたか？」
• 「カリフォルニア州にある 100MW 超の蓄電池プロジェクトを探してください」

開発

# Clone and install in dev mode
cd mcp-server
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[payments]"

# Run with stdio transport (default)
python -m prospector_energy

# Run with SSE transport
python -m prospector_energy --sse

# Test with MCP inspector
npx @modelcontextprotocol/inspector python -m prospector_energy