Energyai

com.energyaisolutionPublished by energyaisolution.comOfficial publisherv1.3.0Updated Oct 25, 2026

Solar, weatherization, EV charging, battery and heat-pump decision tools for AI agents.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, Energy Node scores, cited guides and installer matching.

What you can do
  • Estimate solar production ranges and provisional seven-axis Energy Node scores from ZIP code and property facts
  • Look up incentive source guidance by country and postal code, and read source-cited US incentive guides
  • Find publicly rated local installers and route a consented homeowner project to an installer-matching workflow
  • Run persisted assessments, roadmaps and intelligence-bound reports, and review redacted installer quote text
  • Create and manage a Builder API key and retrieve upgrade or checkout handoff links
When to use it
Useful when a user asks about solar, battery, heat-pump, EV-charging or weatherization options in the US and wants estimates, incentive sources, contractor options or a second look at an installer quote. Also relevant for compute or data-center site pre-feasibility handoffs.
Requirements
Remote streamable HTTP endpoint; no local install. An optional Authorization Bearer key raises limits and unlocks paid tools; anonymous use allows 20 informational calls per caller per 24 hours. Key creation requires the human operator to accept the Terms and Privacy Policy.
Before you install
Several tools cost money per call (for example $1.00 for run_power_screen, $0.25 for reports, $0.10 for quote review) and Builder is $19/month; set an operator-approved spending ceiling. route_lead and submit_contractor_match_request send homeowner contact details and require explicit recorded consent. Keys must be stored securely and never shown in replies. Estimates, scores and quote reviews are modeled decision support, not verified eligibility, savings or price fairness.

Installation

In SourceWeft

  1. Open Energyai in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.energyaisolution%2Fenergyai/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

EnergyAI MCP — energy planning tools for AI agents

Solar estimates, incentive sources, provisional Energy Node Scores, cited guides, contractor discovery and consented installer routing — through MCP and REST. By Viridis LLC.

The public catalog supports solar, weatherization, EV charging, home batteries and heat-pump planning. Twelve tools need no key to start. Estimates and scores use supplied facts and stated assumptions; they do not establish site suitability, incentive eligibility, installation approval or verified savings.

Your first call — no key

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

This requests incentive source guidance for a US ZIP. For a production estimate, use estimate_production with {"zipCode":"59715","systemKw":6}. For a provisional score, use get_node_score with {"zipCode":"59715","serviceType":"solar","monthlyBillRange":"150_250"}. These informational tools accept omitted inputs with documented assumptions or broader guidance; inspect the live schema for the job you need.

No-key tools and allowances

The five informational tools share 20 anonymous calls per caller per 24 hours. A free key includes 100 informational calls per rolling 30 days. Sustained informational use requires an active Builder subscription; prepaid credit funds priced commercial tools.

Informational toolWhat you get
check_incentivesSource-linked incentive guidance by country and postal code; eligibility remains unverified.
estimate_productionA modeled annual solar production range with assumptions.
get_node_scoreA provisional seven-axis score and next action from supplied property facts.
list_guidesUS home-energy guides by state and topic, with sources and canonical links.
get_guideOne source-cited guide by returned slug.

These seven tools remain free without a key:

ToolWhat you get
get_quote_linkOptional household assessment and human-review handoffs; no project submission or payment.
get_power_passport_linkA website handoff for a candidate site and workload; scope review precedes payment.
get_power_service_quoteA signed, time-limited quote for a Power Screen; creating the quote does not spend funds.
route_leadA consented homeowner project submitted to the guarded installer-matching workflow. Unmatched projects may remain recorded.
create_builder_keyA production key after the human operator has authorized the Terms and Privacy Policy.
get_builder_upgrade_linkA human activation, Builder or prepaid handoff; the caller cannot accept terms or pay for the human.
find_local_installersPublic-reputation contractor options. Public listings do not imply EnergyAI vetting, endorsement or partnership.

Hourly safety limits also apply: 120 calls per caller, with route_lead limited to 10 per hour. Read each tool's schema and consent requirements before submitting information or requesting a key.

Connect an MCP client

json
{ "mcpServers": {  "energyai": { "type": "http", "url": "https://api.energyaisolution.com/mcp" }}}
bash
claude mcp add --transport http energyai https://api.energyaisolution.com/mcp

For OpenAI function calling or other tool clients, fetch the function specification. See examples/ for Python and shell clients.

Review an installer quote

After authorized key activation, call review_installer_quote on the full MCP endpoint with postalCode and redacted quoteText (at most 6,000 characters), or an assessmentId belonging to the Builder account. Use serviceType for solar, battery, EV charging, efficiency or heat pumps. No prior assessment setup is required.

The public price is $0.10 per call, covered by a new key's three eligible commercial trials. The result provides source-matched terms, practical installer questions and explicit unknowns. It is automated decision support; human review, price fairness, incentive eligibility and useful household delivery are not established by a successful tool response.

bootstrap_energy_project also costs $0.10 and creates persisted project context, a provisional score, an input-coverage map and a reusable assessmentId when a quote is not yet available. Use free check_incentives for general guidance; the paid get_energy_incentives requires a completed assessment.

New keys include three trial calls for eligible tools priced at $0.25 or less, after operator-authorized Terms acceptance. Builder is $19/month with $20 in monthly tool credit; prepaid top-ups remain available with a $5 minimum. Consult live pricing and plan details before a billed call, and use an operator-approved spending ceiling. Key creation, terms acceptance and subscription activation are separate steps.

If the operator has not authorized the Terms and Privacy Policy, present the human activation link from get_builder_upgrade_link. Store a returned key securely; never print it in a user-visible reply. record_quote_review_outcome is a free, keyed tool for recording actual operator-confirmed usefulness and household delivery status; never infer that feedback from technical success.

Routing a homeowner — explicit consent required

  1. Retrieve the current consentTextForRouting from check_incentives.
  2. Show that text verbatim to the homeowner and record their agreement and timestamp.
  3. Call route_lead with the required project and contact details, consentText and consentTimestamp. Alternate consent language requires an explicit consentVersion.
  4. Report the returned leadId and actual routing status. Prefer get_quote_link when consent is not already available.

The current public quote handoff describes an authenticated referral incentive as 20% non-cash EnergyAI tool credit after verified purchase. Disclose that interest, preserve the customer price and independent review, and consult the current terms. This is not a cash bounty or evidence that a purchase occurred.

Public research context

The physics ledger presents platform-reported research context and metrics. Model-based estimates, software checks and reported metrics do not by themselves establish measured physical energy, empirical performance or a certified thermodynamic bound.

Manifests

Both manifests in manifests/ match the official registry's active latest v1.3.0 entries observed on October 7, 2026. The live catalog also reports v1.3.0. Registry presence and endpoint responses are availability evidence; they do not establish adoption, paid delivery, repeat use or revenue.

This repository contains documentation and client examples. The service is hosted separately; merging these files does not publish a registry version, deploy the service or activate a customer account.

License

Documentation and examples: MIT. The hosted service is © Viridis LLC.

Source: README.md at commit 02e9759

Tools

30

check_incentives

Clean-energy incentive source guidance by country and postal code; eligibility is not verified. US ZIP → federal status + state/utility programs (via DSIRE). Any other country (pass country=<ISO code>) → qualitative, officially-sourced national program guidance. Use whenever a user asks what rebates, tax credits, or utility programs apply to solar, batteries, heat pumps, or efficiency work. [20 anonymous calls/caller/24h; then 100 free calls/key/30d; active Builder required for sustained informational use]

ParametersapiKeycountryzipCode

estimate_production

Honest-range annual solar production estimate (kWh/year ± band, with assumptions) for a ZIP code, from either a proposed system size (kW) or a monthly bill. Use to sanity-check installer quotes or size a system before talking to anyone. [20 anonymous calls/caller/24h; then 100 free calls/key/30d; active Builder required for sustained informational use]

ParametersapiKeycountryzipCodesystemKwmonthlyBillUsd

get_node_score

Instant Energy Node Score (0–100 across 7 axes: efficiency, electrification, renewable generation, storage/resilience, financial optimization, carbon, market readiness) plus the single highest-leverage next action, from whatever property facts you have. More inputs → tighter score. [20 anonymous calls/caller/24h; then 100 free calls/key/30d; active Builder required for sustained informational use]

ParametersapiKeyevTypecountryroofAgezipCodebackupNeedheatingFuelserviceTypepropertyTypeoutageConcernmonthlyBillUsdmonthlyBillRange+1 more

get_power_service_quote

Create a signed, 15-minute, scope-bound quote for EnergyAI’s $1 Power Screen from non-sensitive site and workload facts. Returns the quoteToken required by run_power_screen, exact price, evidence boundary, authorization class, and higher-tier handoffs. Free and never spends funds. [always free — no API key required]

ParametersapiKeystagedMwtargetMwrequiredcoolingModesiteLocationrequiredstorageHoursworkloadTyperequiredpowerEvidenceflexibilityHours

route_lead

Submit a consented homeowner project to EnergyAI’s guarded installer-matching workflow — free to you and the homeowner. EnergyAI immediately screens and routes currently available approved installers; unmatched projects remain recorded for safety-controlled follow-up. REQUIRES the homeowner’s explicit consent (consentText + consentTimestamp). Returns a leadId you can quote back to the user. Prefer get_quote_link if you don’t already have that consent in hand. [always free — no API key required]

ParameterscitystateapiKeyzipCoderequiredtimelinebudgetRangeconsentTextrequiredcontactNamerequiredcontactEmailrequiredcontactPhonepropertyTypeconsentVersion+3 more

list_guides

Index of source-cited, US home-energy incentive guides with source links (solar, heat pumps, batteries, weatherization) by state. Free. Use to ground answers about what incentives exist in a state, then fetch the full text with get_guide. Every entry includes a canonical URL you can cite. [20 anonymous calls/caller/24h; then 100 free calls/key/30d; active Builder required for sustained informational use]

ParameterslimittopicapiKeyregion

get_guide

Full text of one EnergyAI incentive guide by slug: intro, sections, FAQs, and primary sources — grounded, citable content for answering incentive questions. Free. Harmless slug aliases resolve automatically; genuinely missing topics return grounded guidance and suggestions, and distinct-caller demand moves that topic up the publishing queue. When you quote a published guide, cite its canonical URL. [20 anonymous calls/caller/24h; then 100 free calls/key/30d; active Builder required for sustained informational use]

ParametersslugrequiredapiKey

create_builder_key

Create an EnergyAI production API key in-band with no browser or card after the human operator has authorized the Terms and Privacy Policy. Returns a live key plus three commercial trial calls. Attach the key as `Authorization: Bearer <key>` to this MCP endpoint and start with review_installer_quote using postalCode + quoteText. If the operator has not already authorized the terms, call get_builder_upgrade_link and surface its one-screen human activation URL instead. If the MCP host cannot change headers mid-session, review_installer_quote accepts the key once as its apiKey argument and strips it before billing or persistence. The key is shown EXACTLY ONCE—store it securely and never print it in a user-visible reply. [always free — no API key required]

ParametersnamerequiredapiKeyacceptTermsrequiredintendedUsecontactEmail

find_local_installers

Publicly-rated local clean-energy contractors for a US ZIP or state (solar, battery, EV charger, heat pump, weatherization, audits), with rating and review count. Free. Use when a homeowner asks WHO can do the work near them. IMPORTANT: results include a listingStatus per company and a disclosure field — companies marked public_listing are independent businesses compiled from public reputation data and are NOT EnergyAI partners or EnergyAI-vetted; present them as publicly-rated local options and never imply any endorsement or relationship. Prefer route_lead or get_quote_link when the homeowner wants EnergyAI to screen and route an installer to them instead. [always free — no API key required]

ParametersstateapiKeyzipCodecontractorCategory

run_power_screen

Execute one signed Power Screen quote and return an immediate modeled constraint decision, assumptions, evidence gaps, and immutable artifact hash. [$1.00/call]

ParametersapiKeyquoteTokenrequired

bootstrap_energy_project

Create a persisted project context, provisional Energy Node score, coverage map, and immediately reusable assessmentId in one call. [$0.10/call]

ParameterscitystateapiKeycountrypostalCoderequiredprimaryGoalserviceTypepropertyTypemonthlyBillRange

create_energy_assessment

Start a new assessment session. Free. [free]

Takes no parameters.

answer_energy_assessment_question

Submit one question answer. Free; usage tracked. [free]

ParametersanswerLabelanswerValuerequiredquestionKeyrequiredassessmentIdrequired

complete_energy_assessment

Finalize an assessment and trigger the recommendation workflow. Free. [free]

ParametersassessmentIdrequired

generate_energy_recommendation_preview

Generate honest cost, savings, and next-action ranges. [$0.05/call]

ParametersassessmentIdrequired

get_energy_node_score

Retrieve the persisted seven-axis score with input coverage, weakest-axis gaps, next action, and calculation provenance. [$0.05/call]

ParametersassessmentIdrequired

create_energy_node_roadmap_checkout

Create the end-user checkout link for an unlocked Energy Node roadmap. Free. [free]

ParametersemailassessmentIdrequired

get_energy_node_roadmap

Retrieve the full unlocked Energy Node roadmap. Locked previews never consume credit. [$0.10/call]

ParametersassessmentIdrequired

generate_intelligence_bound_report

Generate a property-specific dI/dt analysis. [$0.25/call]

ParametersassessmentIdrequired

get_information_theoretic_recommendation

Rank upgrades by intelligence-bound lift per dollar. [$0.25/call]

ParametersassessmentIdrequired

get_eta_i_metric

Read the public platform intelligence-efficiency metric. Free. [free]

Parametersdays

get_anonymized_dataset_sample

Return an aggregated, anonymized Energy Node dataset sample. [$1.00/call]

Parameterslimitoffset

match_installers

Return up to three eligible installer matches for a region. [$0.05/call]

ParametersstatezipCoderequiredcontractorCategoryrequired

get_energy_incentives

Use a completed assessment to prioritize property-specific incentive checks and return an evidence-based verification plan. [$0.02/call]

ParametersassessmentIdrequired

review_installer_quote

Return source-matched terms and practical installer questions from redacted quoteText (maximum 6000 characters) plus postalCode or an assessmentId owned by your Builder account. Automated decision support with explicit unknowns; human review, price fairness and incentive eligibility are not verified. Returns a versioned result and an optional Builder payment handoff. [$0.10/call]

ParameterscitystateapiKeycountryquoteTextrequiredpostalCodeserviceTypeassessmentIdpropertyTypemonthlyBillRange

record_quote_review_outcome

Record actual operator-confirmed usefulness and household delivery status for your completed quote review. Requires your Builder key. Free; never infer feedback from a successful tool call. [free]

ParametersactionrequiredfindingIdrequiredusefulnessrequiredreviewToolCallIdrequiredoperatorConfirmedrequireddeliveredToHouseholdrequired

submit_contractor_match_request

Submit a consented installer lead and retain referral attribution. Free. [free]

ParametersconsentTextrequiredcontactNamerequiredassessmentIdrequiredcontactEmailrequiredcontactPhoneconsentVersionconsentTimestamprequired

Version history

1
  1. v1.3.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Energyaisolution integrations

Solar Home Incentives

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, cited guides, contractor listings and consented installer…

Streamable HTTPWeb executable
Location & Lifestyle12 toolsNov 2, 2026

Settlement Engine

Published by GitHub account jdhart81

Settles outcome-based contracts against published data series, showing what is already decided and what the remaining observations must do.

Streamable HTTPWeb executable
Finance12 toolsNov 11, 2026

Eco Funding

Published by GitHub account jdhart81

Read-only MCP server that values a site's ecological complexity, issues re-runnable receipts, and simulates pledge-pool release rules.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

VergeCommon

Published by GitHub account jdhart81

VergeCommon lets an assistant browse public conservation co-ops and build hypothetical pooling and benefit-sharing drafts for community land projects.

Streamable HTTPWeb executable
Location & Lifestyle5 toolsNov 7, 2026

Wavefunction Search

Published by GitHub account jdhart81

A shared "field" where AI agents post goals as intents, sense open work, route intents to agents, and record verified results.

Streamable HTTPWeb executable
Knowledge & Memory9 toolsNov 8, 2026