com.energyaisolution/energyai

Official15 tools

by jdhart81

Free energy intelligence for agents: incentives, solar estimates, node scores, installer routing.

Energy intelligence platform providing solar estimates, incentive data, and installer routing.

solarenergyincentivesestimatesinstallerrenewable energyrebates

Topics

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

Captured live from the server via tools/list.

create_energy_assessment

Start a new assessment session. Free. [free]

No parameters.

answer_energy_assessment_question

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

Parameters (4)

assessmentIdstringrequired
questionKeystringrequired
answerValuestringrequired
answerLabelstring

complete_energy_assessment

Finalize assessment; triggers autopilot. [free]

Parameters (1)

assessmentIdstringrequired

generate_energy_recommendation_preview

Free-tier preview (ranges, next best action). $0.15 per call. [$0.15/call]

Parameters (1)

assessmentIdstringrequired

get_energy_node_score

7-axis Energy Node Score breakdown. $0.15 per call. [$0.15/call]

Parameters (1)

assessmentIdstringrequired

create_energy_node_roadmap_checkout

Get a Stripe Checkout URL for the $19 paid roadmap (end user pays Viridis directly). [free]

Parameters (2)

assessmentIdstringrequired
emailstring

get_energy_node_roadmap

Full unlocked roadmap (after end-user $19 payment). $0.25 per call. [$0.25/call]

Parameters (1)

assessmentIdstringrequired

generate_intelligence_bound_report

Property-specific dI/dt analysis with current and post-roadmap projection. $0.50 per call. [$0.50/call]

Parameters (1)

assessmentIdstringrequired

get_information_theoretic_recommendation

V2 recommendation: ranks upgrades by intelligence-bound lift per dollar. $1.00 per call. [$1.00/call]

Parameters (1)

assessmentIdstringrequired

get_eta_i_metric

Public platform intelligence-efficiency metric. Free. [free]

Parameters (1)

daysnumber

get_anonymized_dataset_sample

Anonymized aggregated Energy Node profiles for research. Free for verified .edu merchants. $2.00/call commercial. [$2.00/call]

Parameters (2)

limitnumber
offsetnumber

match_installers

Up to 3 installer matches in a region. $0.50 per call. [$0.50/call]

Parameters (3)

contractorCategorystringrequired
zipCodestringrequired
statestring

get_energy_incentives

Honest, 2026-accurate state/utility incentive checklist by ZIP (DSIRE-grounded). $0.10 per call. [$0.10/call]

Parameters (2)

zipCodestring
assessmentIdstring

review_installer_quote

Quote Guardian: benchmark an installer quote vs our per-home estimate; flag overcharge / undersizing / missing warranty. $0.25 per call. [$0.25/call]

Parameters (2)

assessmentIdstringrequired
quoteTextstringrequired
The installer quote text to review.

submit_contractor_match_request

Submit a consented installer lead - FREE. The referring agent earns a bounty when the installer buys the lead (affiliate model). Requires consentText + consentTimestamp. [free]

Parameters (7)

assessmentIdstringrequired
contactNamestringrequired
contactEmailstringrequired
contactPhonestring
consentTextstringrequired
EXACT consent text shown to end user.
consentTimestampstringrequired
consentVersionstring

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": {
    "energyai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.energyaisolution.com/mcp"
      ]
    }
  }
}

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

Topics

create_energy_assessment

answer_energy_assessment_question

complete_energy_assessment

generate_energy_recommendation_preview

get_energy_node_score

create_energy_node_roadmap_checkout

get_energy_node_roadmap

generate_intelligence_bound_report

get_information_theoretic_recommendation

get_eta_i_metric

get_anonymized_dataset_sample

match_installers

get_energy_incentives

review_installer_quote

submit_contractor_match_request

EnergyAI MCP — free energy intelligence for AI agents

Free tools — no key, no signup

Quickstart

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

Plain REST

OpenAI function-calling / LangChain / CrewAI

Routing a homeowner (consent required)

The physics ledger

Manifests

License

Install