solar-home-incentives

EnergyAI MCP — AI エージェント向けエネルギー計画ツール

太陽光発電の推定、インセンティブ情報源、暫定的な Energy Node スコア、出典付きガイド、施工業者の検索、同意に基づく施工業者への振り分けを、MCP と REST 経由で提供します。 Viridis LLC によるサービスです。

公開カタログは、太陽光発電、住宅の省エネ改修、EV 充電、家庭用蓄電池、ヒートポンプの計画をサポートしています。12 個のツールは、キーなしで利用を開始できます。推定値とスコアは、提供された事実と明示された前提に基づいており、設置場所の適性、インセンティブの適格性、設置承認、または実証済みの節約額を確定するものではありません。

最初の呼び出し — キー不要

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

これは米国の ZIP コードに関するインセンティブ情報源の案内をリクエストします。本番環境で推定するには、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}
• エージェントガイド · ライブカタログ · 現在の料金
• 公式 MCP レジストリ： com.energyaisolution/energyai · com.energyaisolution/solar-home-incentives

キー不要のツールと利用枠

5 つの情報提供ツールでは、呼び出し元ごとに24 時間あたり匿名で 20 回まで利用できます。無料キーには、30 日間のローリング期間で情報提供ツールを 100 回利用できる枠が含まれます。情報提供ツールを継続的に利用するには、有効な Builder サブスクリプションが必要です。料金が発生する商用ツールには、プリペイドクレジットを使用します。

情報提供ツール	提供内容
check_incentives	国と郵便番号に基づく、情報源へのリンク付きインセンティブ案内。適格性は未確認のままです。
estimate_production	前提条件を含む、モデル化された年間太陽光発電量の範囲。
get_node_score	提供された物件情報に基づく、暫定的な 7 軸スコアと次のアクション。
list_guides	出典と正規リンクを含む、州およびトピック別の米国住宅エネルギーガイド。
get_guide	返されたスラッグを指定して取得する、出典を明記したガイド 1 件。

以下の 7 つのツールは、キーなしで引き続き無料で利用できます。

ツール	提供内容
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 による審査、推奨、または提携を意味しません。

1 時間あたりの安全上限も適用されます。呼び出し元ごとに 120 回までで、route_lead は 1 時間あたり 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 およびシェルのクライアントについては、examples/を参照してください。

インストーラーの見積もりを確認する

認証済みのキーを有効化した後、完全な MCP エンドポイントでreview_installer_quoteを呼び出し、postalCodeと、機密情報を削除したquoteText（最大6,000文字）、または Builder アカウントに属するassessmentIdを指定してください。太陽光発電、蓄電池、EV 充電、エネルギー効率、ヒートポンプにはserviceTypeを使用してください。事前にアセスメントを設定する必要はありません。

公開価格は1回の呼び出しにつき$0.10です。新しいキーには、対象となる商用トライアルが3回分含まれています。結果には、情報源と照合された契約条件、実用的なインストーラーへの質問、不明点が明示されます。これは自動化された意思決定支援です。ツールの応答が成功しても、人による確認、公正な価格設定、インセンティブの適用資格、または世帯への有益な提供が実証されるわけではありません。

bootstrap_energy_projectも**$0.10**で、見積もりがまだない場合に、保存されるプロジェクトコンテキスト、暫定スコア、入力カバレッジマップ、再利用可能なassessmentIdを作成します。一般的なガイダンスには無料のcheck_incentivesを使用してください。有料のget_energy_incentivesを使用するには、アセスメントが完了している必要があります。

新しいキーには、オペレーターが利用規約への同意を承認した後、価格が$0.25以下の対象ツールに使えるトライアル呼び出しが3回分含まれます。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を優先してください。

現在公開されている見積もり案内では、認証済みの紹介インセンティブについて、購入確認後に現金以外のEnergyAIツールクレジットを20%分付与すると説明されています。この利害関係を開示し、顧客価格と独立した確認を維持し、最新の規約を参照してください。これは現金の報奨金ではなく、購入が行われた証拠でもありません。

公開研究コンテキスト

物理学台帳には、プラットフォームが報告する研究コンテキストと指標が掲載されています。モデルに基づく推定、ソフトウェアによる検査、報告された指標だけでは、実測された物理エネルギー、実証的な性能、認証済みの熱力学的限界は立証されません。

マニフェスト

manifests/内の両方のマニフェストは、2026年10月7日時点で確認された公式レジストリの有効な最新v1.3.0エントリーと一致しています。ライブカタログもv1.3.0を報告しています。レジストリへの掲載とエンドポイントの応答は、利用可能であることを示す証拠です。採用、有料での提供、継続利用、収益を立証するものではありません。

このリポジトリにはドキュメントとクライアントの例が含まれています。サービスは別途ホストされています。これらのファイルをマージしても、レジストリのバージョンは公開されず、サービスはデプロイされず、顧客アカウントも有効化されません。

ライセンス

ドキュメントと例：MIT。ホスト型サービス：© Viridis LLC。