EnergyAI — Solar Estimates, Incentives & Installer Routing (free, no key)

EnergyAI MCP — 面向 AI Agent 的能源规划工具

通过 MCP 和 REST 提供太阳能估算、激励措施来源、临时 Energy Node Scores、附来源引用的指南、承包商查询和经用户同意的安装商对接。 由 Viridis LLC 提供。

公开目录支持太阳能、住宅节能改造、电动汽车充电、家庭电池和热泵规划。十二种工具无需密钥即可开始使用。估算和评分依据提供的事实及明示的假设生成；它们不能证明场地适用性、激励措施资格、安装获批或节省金额已得到核实。

首次调用——无需密钥

curl -X POST https://api.energyaisolution.com/api/v1/agent/check_incentives \
  -H 'content-type: application/json' -d '{"args":{"zipCode":"59715"}}'

此调用会查询美国邮政编码对应的激励措施来源指南。若要获取生产估算，请使用 estimate_production，并传入 {"zipCode":"59715","systemKw":6}。若要获取临时评分，请使用 get_node_score，并传入 {"zipCode":"59715","serviceType":"solar","monthlyBillRange":"150_250"}。这些信息类工具允许省略输入，并采用文档说明的假设或提供更宽泛的指南；请查看实时架构，了解所需任务对应的工具。

• 完整 MCP 端点： https://api.energyaisolution.com/mcp
• 发现用 MCP 端点： https://api.energyaisolution.com/mcp/solar
• REST： POST https://api.energyaisolution.com/api/v1/agent/{tool}
• Agent 指南 · 实时目录 · 实时价格
• 官方 MCP Registry： com.energyaisolution/energyai · com.energyaisolution/solar-home-incentives

无密钥工具和调用额度

五种信息类工具共用每位调用者每 24 小时 20 次匿名调用的额度。免费密钥包含每滚动 30 天 100 次信息类调用。持续使用信息类工具需要有效的 Builder 订阅；预付额度用于支付按价计费的商业工具。

信息类工具	可获取内容
check_incentives	按国家和邮政编码提供附有来源链接的激励措施指南；资格尚未核实。
estimate_production	基于假设建模的年度太阳能发电量范围。
get_node_score	根据提供的房产信息生成临时七轴评分和下一步行动。
list_guides	按州和主题整理的美国住宅能源指南，附带来源和规范链接。
get_guide	根据返回的 slug 获取一份附有来源引用的指南。

以下七种工具无需密钥，且始终免费：

工具	可获取内容
get_quote_link	可选的家庭评估和转交人工审核；不会提交项目或付款。
get_power_passport_link	为候选场地和工作负载提供网站转交；付款前会先审核范围。
get_power_service_quote	获取 Power Screen 的签名限时报价；创建报价不会消耗资金。
route_lead	将经用户同意的房主项目提交至受保护的安装商匹配工作流。未匹配的项目仍可能被记录。
create_builder_key	人工操作者授权《服务条款》和《隐私政策》后，生成生产密钥。
get_builder_upgrade_link	提供由人工处理的激活、Builder 或预付转交流程；调用者不能代替人工接受条款或付款。
find_local_installers	提供基于公开声誉的承包商选项。公开列表不代表 EnergyAI 已审核、背书或建立合作关系。

此外还有每小时安全限制：每位调用者 120 次，其中 route_lead 每小时最多 10 次。提交信息或申请密钥前，请阅读每种工具的架构和同意要求。

连接 MCP 客户端

{ "mcpServers": {
  "energyai": { "type": "http", "url": "https://api.energyaisolution.com/mcp" }
}}

claude mcp add --transport http energyai https://api.energyaisolution.com/mcp

对于 OpenAI 函数调用或其他工具客户端，请获取函数规范。Python 和 shell 客户端示例请参阅 examples/。

审核安装商报价

获得授权的密钥激活后，请在完整 MCP 端点上调用 review_installer_quote，并提供 postalCode 和经脱敏的 quoteText（最多 6,000 个字符），或提供属于 Builder 账户的 assessmentId。使用 serviceType 指定太阳能、电池、EV 充电、能效或热泵。无需预先设置评估。

公开价格为每次调用 $0.10，新密钥的三次符合条件的商业试用调用可抵扣此费用。结果提供与来源匹配的条款、实用的安装商问题以及明确的未知项。这是自动化决策支持；工具成功响应并不能证明经过人工审核、价格公平、符合激励条件或已向家庭提供有用服务。

bootstrap_energy_project 的费用也是 $0.10，当报价尚不可用时，它会创建持久化的项目上下文、临时评分、输入覆盖率映射以及可复用的 assessmentId。一般指导可免费使用 check_incentives；付费工具 get_energy_incentives 需要已完成的评估。

新密钥在运营方授权接受条款后，包含三次符合条件且价格不超过 $0.25 的工具试用调用。Builder 订阅价格为每月 $19，包含每月 $20 的工具额度；仍可预付充值，最低金额为 $5。在执行计费调用前，请查看实时价格和套餐详情，并使用运营方批准的支出上限。创建密钥、接受条款和激活订阅是不同的步骤。

如果运营方尚未授权接受条款和隐私政策，请提供 get_builder_upgrade_link 返回的人工激活链接。安全保存返回的密钥；切勿在用户可见的回复中输出该密钥。record_quote_review_outcome 是免费的密钥工具，用于记录运营方实际确认的实用性以及家庭服务交付状态；切勿根据技术成功推断反馈。

为房主转介服务——必须明确获得同意

1. 从 check_incentives 获取当前的 consentTextForRouting。
2. 将该文本原样展示给房主，并记录其同意情况和时间戳。
3. 使用必需的项目和联系信息、consentText 及 consentTimestamp 调用 route_lead。如使用其他同意文本，必须明确提供 consentVersion。
4. 报告返回的 leadId 和实际转介状态。如果尚未获得同意，优先使用 get_quote_link。

当前公开报价转介说明：经过身份验证的推荐激励为购买核实后获得 20% 的非现金 EnergyAI 工具额度。请披露该利益关系，维护客户价格和独立审核，并查阅当前条款。这不是现金奖励，也不能证明已发生购买。

公开研究背景

物理学台账展示平台报告的研究背景和指标。基于模型的估算、软件检查和报告指标本身并不能证明测得的物理能量、实证性能或经认证的热力学界限。

清单

manifests/ 中的两个清单均与官方注册表中观察到的最新有效条目 v1.3.0 相符，观察日期为 2026 年 10 月 7 日。实时目录也报告 v1.3.0。注册表条目和端点响应可以证明服务可用，但不能证明用户采用、付费交付、重复使用或产生收入。

此仓库包含文档和客户端示例。服务托管在其他位置；合并这些文件不会发布注册表版本、部署服务或激活客户账户。

许可证

文档和示例：MIT。托管服务版权归 Viridis LLC 所有。