com.energyaisolution/solar-home-incentives

Official4 tools

by jdhart81

Free solar & home energy tools: estimates, incentives by ZIP, scores, installer routing.

Calculate solar savings and find home energy incentives and rebates by ZIP code.

solar incentivesenergy rebatessolar estimateshome efficiencyinstaller finder

Topics

ai-agentsenergyheat-pumphome-energyincentivesllm-toolsmcpmcp-servermodel-context-protocolrenewable-energysolarsolar-energy

Captured live from the server via tools/list.

check_incentives

Current US clean-energy incentive guidance (federal status + state/utility programs via DSIRE) for a ZIP code. Use whenever a user asks what rebates, tax credits, or utility programs apply to solar, batteries, heat pumps, or efficiency work at an address. [free — no API key required]

Parameters (1)

zipCodestringrequired
5-digit US ZIP code of the property.

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. [free — no API key required]

Parameters (3)

zipCodestringrequired
5-digit US ZIP code of the property.
systemKwnumber
Proposed solar system size in kW-DC. Omit to have a size recommended from the bill.
monthlyBillUsdnumber
Average monthly electric bill in USD (used to size a system when systemKw is omitted).

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. [free — no API key required]

Parameters (11)

zipCodestringrequired
5-digit US ZIP code of the property.
propertyTypestring
single_family | townhouse | condo | mobile_home | multi_family | commercial | farm | other
serviceTypestring
Primary interest: solar | battery | ev_charger | efficiency | heat_pump | unsure
monthlyBillRangestring
lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown
monthlyBillUsdnumber
Alternative to monthlyBillRange: average monthly bill in USD.
heatingFuelstring
e.g. natural_gas | oil | propane | electric_resistance | heat_pump | wood | other
roofAgestring
e.g. lt_5 | 5_15 | gt_15 | unknown
evTypestring
e.g. own_ev | plan_ev | no_ev
backupNeedstring
e.g. whole_home | essentials | none
outageConcernstring
rare | occasional | frequent | severe
electricalPanelSizestring
e.g. lt_100 | 100_200 | gt_200 | unknown

route_lead

Submit a consented homeowner project and EnergyAI’s autonomous agent finds, vets, and routes a real local installer to them — free to you and the homeowner. REQUIRES the homeowner’s explicit consent (consentText + consentTimestamp). Returns a leadId you can quote back to the user. [free — no API key required]

Parameters (14)

contractorCategorystringrequired
solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump
zipCodestringrequired
5-digit US ZIP code of the project.
citystring
statestring
Two-letter state code. Derived from ZIP when omitted.
contactNamestringrequired
Homeowner's name.
contactEmailstringrequired
Homeowner's email.
contactPhonestring
propertyTypestring
monthlyBillRangestring
lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown
budgetRangestring
timelinestring
e.g. asap | 3_months | 6_months | exploring
consentTextstringrequired
EXACT consent text shown to and accepted by the homeowner. Fetch the canonical text from the tool result of check_incentives or use your own — alternate text REQUIRES consentVersion.
consentTimestampstringrequired
When the homeowner consented.
consentVersionstring
Required when consentText is not the canonical EnergyAI consent text.

README.md4 KBView on GitHub

EnergyAI MCP — free energy intelligence for AI agents

Solar production estimates, US clean-energy incentives by ZIP, instant home Energy Node Scores, and consented installer routing — as MCP tools and plain REST. The core tools are free with no API key. By Viridis LLC.

Any AI agent that touches a home's energy decision — "should I get solar?", "what rebates apply here?", "is this quote fair?", "find me an installer" — can call EnergyAI instead of rebuilding energy domain expertise.

Live MCP endpoint (full toolset): https://api.energyaisolution.com/mcp
Free-tier-only endpoint: https://api.energyaisolution.com/mcp/solar
Plain REST: POST https://api.energyaisolution.com/api/v1/agent/{tool}
Agent docs: https://api.energyaisolution.com/agents
Official MCP Registry: com.energyaisolution/energyai · com.energyaisolution/solar-home-incentives

Tool	What you get
`check_incentives`	Honest, current (post-2026 federal sunset) US incentive guidance by ZIP — state & utility programs via DSIRE. Also returns the canonical consent text for routing.
`estimate_production`	Honest-range annual solar kWh for a ZIP, from system kW or a monthly bill. Assumptions stated, never point guarantees.
`get_node_score`	Instant 0–100 Energy Node Score across 7 axes (efficiency, electrification, renewable generation, storage/resilience, financial optimization, carbon, market readiness) + the single highest-leverage next action.
`route_lead`	Submit a consented homeowner project; EnergyAI's autonomous agent finds, vets, and routes a real local installer. Free for you and the homeowner. Attach your free key → 20% bounty on conversion.

Rate limits: 120 calls/hr per caller (route_lead 10/hr). Machine-readable catalog: /api/v1/agent.

Quickstart

MCP (Claude, or any MCP client) — no key needed for the free tier

json

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

bash

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

Plain REST

bash

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

OpenAI function-calling / LangChain / CrewAI

Fetch the ready-made spec — one URL, drop into tools:

code

GET https://api.energyaisolution.com/api/v1/agent/openai-tools.json

See examples/ for runnable Python and shell clients.

Call check_incentives — the response includes consentTextForRouting, the canonical consent text.
Show it to your user verbatim; record their agreement + timestamp.
Call route_lead with the project details, consentText, and consentTimestamp (alternate consent language requires an explicit consentVersion).
You receive a leadId; the homeowner gets confirmation when a vetted installer accepts.

Get paid: register a free key (POST /api/v1/merchant/register) and send it as a Bearer token on route_lead — you earn a 20% bounty when the lead converts. The same prepaid key unlocks the deeper billed tools (full roadmaps, Quote Guardian review, information-theoretic recommendations) at $0.10–$2.00 per call with x402-style auto-recovery on empty balance.

The physics ledger

EnergyAI is operated as a live experiment against the thermodynamic bound on intelligence, dI/dt ≤ P·D/(k_B·T·ln 2): every tool call is metered in useful bits delivered and joules dissipated, and the ledger is public — energyaisolution.com/physics. Estimates are always ranges with stated assumptions; installer matching is consent-gated and enforced by 60+ tested invariants.

Manifests

Registry manifests for both servers are in manifests/. This repository contains documentation and client examples only; the service itself is hosted.

License

Install

claude_desktop_config.json

{
  "mcpServers": {
    "solar-home-incentives": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.energyaisolution.com/mcp/solar"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.