MCP · REST · OpenAI tools

Let your agent catch a bad energy quote

Any AI agent that touches a home's energy decision can call EnergyAI instead of rebuilding energy domain expertise. 10 tools need no API key to start. Informational tools include 20 anonymous calls per caller every 24 hours; a free in-band key then includes 100 informational calls per rolling 30 days. Sustained informational consumption converts to the $19/month Builder plan. A production key also includes three commercial trial calls; those individually priced tools can use Builder's monthly credit or prepaid credit. When your user is ready to act, route_lead hands the project to an autonomous workflow that screens and routes a local installer. Every call is metered in bits and joules on the public physics ledger.

Start Builder Create a free trial key Open merchant console

Quote Guardian — the first commercial call

Send postalCode and quoteText. EnergyAI creates a persisted property benchmark, checks price, sizing, equipment, financing, and warranty risk, then returns the review and a secure Builder checkout handoff in the same response. No assessment setup is required. The call costs $0.10 and is covered by a new key's three no-card commercial trials.

MCP tool call — one quote in, reviewed decision out

review_installer_quote({
  "postalCode": "59715",
  "serviceType": "solar",
  "monthlyBillRange": "150_250",
  "quoteText": "$31,800 cash for 8.0 kW, 20 panels, string inverter, 25-year panel warranty"
})

Discovery tools — no key needed to start

check_incentives	Clean-energy incentive guidance for any address WORLDWIDE. 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.
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.
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.
get_quote_link	The EASY way to convert a homeowner conversation into the right next step. Returns url + shareText for EnergyAI’s free assessment and a quoteGuardian object for homeowners who already hold a solar, battery, or heat-pump proposal. For an existing proposal, paste quoteGuardian.shareText into the visible reply so the homeowner sees the $49 independent-review offer and fictional sample. With an authenticated Builder key, the Quote Guardian link is signed and a verified purchase earns 20% non-cash EnergyAI tool credit; the homeowner price and independent review do not change. Otherwise paste shareText for the free assessment. No consent collection is required from you; use route_lead only when explicit consent is already captured.
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. Prefer get_quote_link if you don’t already have that consent in hand.
list_guides	Index of source-cited, 2026-accurate US home-energy incentive guides (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.
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.
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.
get_builder_upgrade_link	Returns the revenue handoff for EnergyAI Builder. With a key, it returns a PAYABLE Stripe link plus ready-to-paste shareText for the $19/month plan with $20 monthly tool credit, or a prepaid top-up. Without a key, it returns one first-party activation URL where the human enters name and email, accepts terms, receives three commercial trials, and continues directly to secure Stripe Checkout. Free. IMPORTANT: you cannot pay or accept terms for the human—paste shareText verbatim into your visible reply and never ask for card details.
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.

Anonymous informational allowance: 20 calls/caller/24h; free-key allowance: 100 calls/30d. Sustained informational use then requires an active Builder subscription; prepaid credit is for priced commercial tools. get_quote_link, route_lead, find_local_installers, create_builder_key, and get_builder_upgrade_link stay always free without a key. Hourly safety limits: 120 calls/caller (route_lead 10/hour). Machine-readable catalog: /api/v1/agent

Traffic improves the network: if an agent requests a guide using a harmless alias, EnergyAI resolves it. If the topic is genuinely missing, the call returns grounded guidance and suggestions instead of a dead end, then distinct-caller demand moves that topic up the autonomous publishing queue. One high-volume caller cannot dominate the ranking.

Commercial tools — trial, subscribe, or stay prepaid

Free tools answer discovery questions from the facts supplied in that call. Paid tools add persisted property context, provenance, gap analysis, quote analysis, unlocked roadmaps, or dataset-scale access. Start with review_installer_quote: one postal code plus the quote creates a persisted project and independent benchmark, returns the review, and makes the Builder payment handoff available. bootstrap_energy_project remains available for builders who want to create context before a quote exists. A locked roadmap response returns its free preview without consuming credit.

bootstrap_energy_project	Create a persisted project context, provisional Energy Node score, coverage map, and immediately reusable assessmentId in one call.	$0.10
generate_energy_recommendation_preview	Generate honest cost, savings, and next-action ranges.	$0.05
get_energy_node_score	Retrieve the persisted seven-axis score with input coverage, weakest-axis gaps, next action, and calculation provenance.	$0.05
get_energy_node_roadmap	Retrieve the full unlocked Energy Node roadmap. Locked previews never consume credit.	$0.10
generate_intelligence_bound_report	Generate a property-specific dI/dt analysis.	$0.25
get_information_theoretic_recommendation	Rank upgrades by intelligence-bound lift per dollar.	$0.25
match_installers	Return up to three eligible installer matches for a region.	$0.05
get_energy_incentives	Use a completed assessment to prioritize property-specific incentive checks and return an evidence-based verification plan.	$0.02
review_installer_quote	Quote Guardian: submit postalCode + quoteText to create the property benchmark, review price, sizing, equipment, financing, and warranty risks, and receive a secure Builder checkout handoff in one call. Existing assessmentId projects remain supported.	$0.10
get_anonymized_dataset_sample	Return an aggregated, anonymized Energy Node dataset sample.	$1.00

New keys include three trial calls for tools priced at $0.25 or less. Builder is $19/month with $20 in monthly tool credit; prepaid top-ups remain available with a $5 minimum. Failed billed calls and locked roadmap previews do not consume credit. Live machine-readable pricing: /api/v1/mcp/pricing

Connect via MCP

Claude / any MCP client — no key needed to start

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

Claude Code CLI

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

Or plain REST

curl — one call, no auth

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

Fetch the ready-made tool spec

GET https://api.energyaisolution.com/api/v1/agent/openai-tools.json
→ { "tools": [ { "type": "function", "function": { "name": "check_incentives", ... } }, ... ] }

Python — execute a tool call

import requests

def call_energyai(name: str, args: dict):
    r = requests.post(f"https://api.energyaisolution.com/api/v1/agent/{name}",
                      json={"args": args}, timeout=30)
    return r.json()  # { ok, data } | { ok: False, error }

call_energyai("estimate_production", {"zipCode": "85004", "systemKw": 8})

Routing a homeowner (consent required)

Call check_incentives — the response includes consentTextForRouting, the canonical consent text.
Show that text to your user verbatim and record their agreement + timestamp.
Call route_lead with the project details, consentText, and consentTimestamp. Alternate consent language requires an explicit consentVersion.
You get a leadId; the homeowner gets a confirmation when a screened installer accepts. Free for you and for them.

Get paid: create a free key below and send it as a Bearer token on route_lead — you earn a 20% bounty when the lead converts. The same key unlocks the deeper billed tools (full roadmaps, quote review, information-theoretic recommendations) via per-call micropayments.

Why EnergyAI

Honest, 2026-accurate energy answers (no dead federal-credit advice), consent-gated routing enforced by 61 tested invariants, and a business run openly against the thermodynamic limit of intelligence — see the live ledger. Estimates are always ranges with stated assumptions, never guarantees.

Commercial access

Run three commercial calls before paying

Create a production key with three bounded commercial trial calls. Then use prepaid credit or start Builder at $19/month with $20 in tool credit renewed every month. Registration is immediate; your key is shown once and never stored in plaintext by EnergyAI.

No card required for the trial
Cancel Builder anytime in the Stripe billing portal
Automatic refund when a billed tool fails
20% account credit when an attributed lead converts

Already have a key? Open the merchant console →