Solar Home Incentives

com.energyaisolutionPublished by energyaisolution.comOfficial publisherv1.3.0Updated Nov 2, 2026

Solar and home energy discovery: estimates, incentive sources, guides and contractor options.

The publisher's own server: Energyai

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

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

What you can do
  • Look up incentive source guidance by country and postal code, and read source-cited US home-energy guides by state and topic
  • Estimate annual solar production ranges from a ZIP code plus system size or monthly bill, and get a provisional seven-axis Energy Node Score with a suggested next action
  • Find publicly rated local clean-energy contractors for a US ZIP or state
  • Get handoff links for household assessments, a Power Passport site screen, or a signed time-limited Power Screen quote
  • Submit a homeowner project to installer matching with recorded consent, and create or upgrade an API key
When to use it
Useful when a homeowner or agent asks what solar, battery, heat-pump or weatherization incentives exist, wants a rough production estimate or installer shortlist, or needs a consented handoff to a human review or installer-matching service.
Requirements
Remote streamable HTTP endpoint; no local install. No key needed to start, but an optional Authorization Bearer key raises allowances. A key is created in-band after the human operator accepts the Terms and Privacy Policy; paid tools and the Builder subscription are billed separately.
Before you install
Estimates, scores and incentive guidance are modeled or source-linked, not verified eligibility, savings or site suitability. route_lead sends homeowner contact and project details to third-party installers and requires explicit recorded consent. Paid tools cost money per call, and the Builder plan is a recurring subscription; set a spending ceiling. Store any returned key securely and never print it in a reply.

Installation

In SourceWeft

  1. Open Solar Home Incentives 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%2Fsolar-home-incentives/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": {
    "solar-home-incentives": {
      "type": "http",
      "url": "https://api.energyaisolution.com/mcp/solar"
    }
  }
}

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

12

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

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