Prospector Labs Energy

Prospector Energy MCP 服务

MCP（Model Context Protocol）服务，可让 AI Agent 访问 Prospector Labs Energy Data API，包括美国并网队列项目及其里程碑跟踪、分布式发电设施、开发商资料与业绩记录、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"]
    }
  }
}

先用一行命令试用 API：

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

免费 API 密钥约 30 秒即可自行申请：https://api.prospectorlabs.io/start

可用工具（32 个）

Tier 列表示工具所需的方案，详情见 https://api.prospectorlabs.io/plans。这是功能级别，而非价格。免费方案涵盖所有工具，但批量导出除外；同时受单次请求行数上限和每月查询额度限制。

项目与搜索

工具	说明	方案
search_projects	按州、ISO、类型、开发商和容量搜索公用事业规模能源项目	免费
get_project	项目完整详情，包含所有补充字段	免费
get_project_score	项目投资可行性评分明细	免费
get_queue_stats	并网队列汇总统计	免费
get_milestone_summary	里程碑与建设阶段统计	免费
export_projects	批量导出项目 CSV	Access

交易与投资

工具	说明	方案
find_itc_deals	符合 ITC 条件并附有评分的投资机会	免费
get_itc_deal	ITC 交易详细资料	免费
get_itc_summary	ITC 交易管线汇总统计	免费
get_investable_projects	预筛选的可投资项目及评级	免费
get_investable_summary	投资可行性汇总统计	免费
get_deal_sheet	格式化的 1 页交易简介（HTML，可打印为 PDF）	免费

税收抵免

工具	说明	方案
calculate_tax_credits	ITC/PTC 资格及所有 IRA 加成项	免费
check_domestic_content	国内含量 ITC 加成资格（+10%）	免费

开发商

工具	说明	方案
search_developers	按名称搜索开发商资料	免费
get_developer	开发商完整资料及业绩记录	免费
get_developer_projects	特定开发商的所有项目	免费
get_developer_stats	开发商汇总统计	免费

市场数据

工具	说明	方案
get_lmp_monthly	月度平均 LMP 趋势	免费
get_lmp_zones	列出可用的 LMP 定价区域	免费
get_capacity_prices	容量市场拍卖价格	免费
get_fuel_prices	按州和类型划分的燃料价格	免费
get_technology_costs	NREL ATB 成本预测	免费

电网基础设施

工具	说明	方案
get_grid_turbines	美国风力涡轮机（USWTDB）	免费
get_grid_transmission	输电线路（HIFLD）	免费
get_grid_substations	变电站（HIFLD）	免费
get_generators	EIA 发电机组清单	免费

分布式发电

工具	说明	方案
search_dg_projects	搜索分布式发电设施	免费
get_dg_stats	DG 汇总统计	免费
get_investable_dg_projects	预筛选的可投资 DG 项目	免费
get_dg_investable_summary	可投资 DG 汇总统计	免费

实用工具

工具	描述	层级
get_pricing	方案层级；启用 MPP 并自托管时，还会提供每次调用的金额	免费

v0.4.1 新增内容

• 默认使用生产环境 API 基础 URL — https://api.prospectorlabs.io。早期版本默认使用 Railway 主机名，因此现在不再需要设置 PROSPECTOR_API_URL 环境变量。
• 下架两个工具 — 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 获取当前方案列表——这是唯一的权威来源。

层级	提供内容
免费	完整列宽、每次请求的行数上限、每月查询额度。不含批量导出
Access	完整的每日队列——包含所有项目、所有列、所有市场，支持 REST 和 MCP。包含批量 CSV 导出
Enterprise	批量交付、数据仓库共享、SLA，以及重新分发来自第一方的数据记录

Access 和 Enterprise 按合作项目定价 — [email protected]。

Agent 付款（MPP）

此服务还可通过 Machine Payments Protocol (MPP)，以 USDC 按工具调用次数收费，供运行自有实例的运营者使用。

MPP 为可选功能，默认关闭：如果未设置 MPP_RECIPIENT_ADDRESS，paid_tool 会直接返回未封装的工具，且不会发出付款质询。公开的 prospector-energy-mcp 软件包不按调用次数收费——访问权限由 API 密钥对应的方案决定。运营者启用 MPP 后，每次调用的金额在 src/prospector_energy/payments.py 中配置。

启用后的流程如下：

1. Agent 调用付费工具（例如 search_projects）
2. 服务返回付款质询（相当于 HTTP 402）
3. Agent 在 Tempo 区块链上以 USDC 付款
4. 服务验证付款并返回数据
5. 免费工具（统计数据、摘要）始终可免付款使用

AgentCash

此服务也已列入 AgentCash。

示例查询

连接后，可以向 AI Agent 提问：

• “ERCOT 队列中有多少个太阳能项目？”
• “计算西弗吉尼亚州一个 2MW 太阳能项目的税收抵免”
• “查找新泽西州可投资的 ITC 项目，抵免率高于 50%”
• “介绍开发商 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