EnergyAIEnergyAICheck a quote
Menu
Energy decision support · MCP 1.3.0

The energy specialist your agent can call

Help households plan solar, weatherization, EV charging, batteries and heat pumps. Your agent gets planning estimates, incentive sources, quote terms and practical questions to bring back to the person making the decision.

Choose an energy jobConnect your agentCreate a free trial key

12 tools need no key to start. Informational tools share 20 anonymous calls per caller every 24 hours; a free key includes 100 calls per rolling 30 days and three eligible commercial trials. Human review and installer introductions are optional follow-through.

Choose the job in front of your user

Start with one of these free calls. Examples use fictional inputs; replace them with your user's authorized facts.

Solar production and proposals

A modeled annual production range and its assumptions; quote review can extract proposed terms and questions.

First call · no key
estimate_production({
  "zipCode": "59715",
  "country": "US",
  "systemKw": 8
})

No roof survey, shading simulation, structural approval, interconnection approval or independent price benchmark.

Already have a proposal? Review the quoted terms →

Weatherization and efficiency

Source-linked guidance to investigate, followed by get_guide using a returned slug. Quote review can identify missing scope and installer questions.

First call · no key
list_guides({
  "region": "Montana",
  "topic": "weatherization",
  "limit": 3
})

Guides cover the US. No blower-door test, moisture assessment, combustion-safety finding or verified savings.

Already have a proposal? Review the quoted terms →

EV charging at home

A provisional planning score and next action based on supplied facts. Quote review can extract charging-installation terms and open questions.

First call · no key
get_node_score({
  "zipCode": "59715",
  "country": "US",
  "serviceType": "ev_charger",
  "evType": "own_ev",
  "electricalPanelSize": "unknown"
})

No circuit sizing, electrical load calculation, charger compatibility certification or permission to energize equipment.

Already have a proposal? Review the quoted terms →

Home batteries and backup

A provisional planning score and next action. Quote review can extract stated capacity, warranty terms and questions about the proposed scope.

First call · no key
get_node_score({
  "zipCode": "59715",
  "country": "US",
  "serviceType": "battery",
  "backupNeed": "essentials",
  "outageConcern": "occasional"
})

No battery health test, dispatch control, verified backup duration, equipment sizing or fire-safety certification.

Already have a proposal? Review the quoted terms →

Heat pumps and electrification

Source-linked guidance to investigate, followed by get_guide using a returned slug. Quote review can identify stated scope, warranty terms and questions.

First call · no key
list_guides({
  "region": "Montana",
  "topic": "heat_pump",
  "limit": 3
})

Guides cover the US. No building heat-loss calculation, duct design, equipment sizing or cold-weather performance verification.

Already have a proposal? Review the quoted terms →

US guides and installer routing. Non-US incentive guidance and production estimates use disclosed national assumptions. Check source dates and program eligibility before relying on incentive guidance. Agents can read the same capability map directly, or open energyai://capabilities through MCP resources.

Have a quote? Return a useful first review

Send postalCode and quoteText. EnergyAI creates a persisted project context, matches selected terms to your source text, and returns installer questions with explicit unknowns plus an optional Builder payment handoff. Use serviceType solar, battery, ev_charger, efficiency or heat_pump. No assessment setup is required. The call costs $0.10 and is covered by a new key's three no-card commercial trials.
MCP request · after authorized free-key activation
{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "review_installer_quote",
    "_meta": { "toolCallId": "your-unique-case-id", "maxPriceCents": 10 },
    "arguments": {
  "postalCode": "59715",
  "serviceType": "solar",
  "monthlyBillRange": "150_250",
  "quoteText": "$31,800 cash for 8.0 kW, 20 panels, string inverter, 25-year panel warranty"
    }
  }
}

This automated first pass uses redacted text up to 6,000 characters. It does not establish price fairness, incentive eligibility or equipment suitability. The $49 human-reviewed brief is a separate service. Attach your key as a Bearer header. Check live pricing and use an operator-approved price ceiling; reuse the request ID only for an identical retry. After the operator evaluates a result, use record_quote_review_outcome to record their actual feedback. A successful call alone does not demonstrate customer value.

Discovery tools — no key needed to start

check_incentivesClean-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.
estimate_productionHonest-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_scoreInstant 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_linkOptional household handoff: returns a free assessment URL and a separate $49 founding Quote Guardian human-review offer for a solar, battery or heat-pump proposal. For an automated agent result, use review_installer_quote on the full MCP endpoint. Share a household service only when it fits the user request. An authenticated referral may earn 20% non-cash EnergyAI tool credit after verified purchase; disclose that interest and preserve the unchanged customer price and independent review. This tool does not submit a project or create payment. route_lead separately requires explicit household consent.
get_power_passport_linkQualify the minimum non-sensitive project facts for EnergyAI’s $2,500 founding Power Passport and return an attributable website handoff plus ready-to-paste shareText. Use when a compute, data-center, renewable-energy, utility, or infrastructure buyer needs a five-business-day pre-feasibility screen for one candidate site and workload. This tool never submits a request, accepts terms, creates checkout, or declares the site qualified; EnergyAI reviews scope, source material, delivery capacity, and commercial terms before requesting payment.
get_power_service_quoteCreate 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.
route_leadSubmit 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.
list_guidesIndex 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.
get_guideFull 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_keyCreate 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_linkReturns 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_installersPublicly-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_power_service_quote, get_power_passport_link, 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 source-matched questions, 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.
run_power_screenExecute one signed Power Screen quote and return an immediate modeled constraint decision, assumptions, evidence gaps, and immutable artifact hash.$1.00
bootstrap_energy_projectCreate a persisted project context, provisional Energy Node score, coverage map, and immediately reusable assessmentId in one call.$0.10
generate_energy_recommendation_previewGenerate honest cost, savings, and next-action ranges.$0.05
get_energy_node_scoreRetrieve the persisted seven-axis score with input coverage, weakest-axis gaps, next action, and calculation provenance.$0.05
get_energy_node_roadmapRetrieve the full unlocked Energy Node roadmap. Locked previews never consume credit.$0.10
generate_intelligence_bound_reportGenerate a property-specific dI/dt analysis.$0.25
get_information_theoretic_recommendationRank upgrades by intelligence-bound lift per dollar.$0.25
match_installersReturn up to three eligible installer matches for a region.$0.05
get_energy_incentivesUse a completed assessment to prioritize property-specific incentive checks and return an evidence-based verification plan.$0.02
review_installer_quoteReturn 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
get_anonymized_dataset_sampleReturn 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)

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

Referral disclosure: create a free key below and send it as a Bearer token on route_lead — a verified installer payment may earn 20% non-cash tool credit. Disclose that interest; it is not a cash payout. The same key unlocks the deeper billed tools (full roadmaps, quote review, information-theoretic recommendations) via per-call micropayments.

Power Passport — specialist site decision service

Call get_power_passport_link when a compute, data-center, renewable-energy, utility, or infrastructure buyer needs one bounded site decision. The tool organizes non-sensitive project facts and returns ready-to-share language for the $2,500 founding, five-business-day Power Passport. The standard price after the first five accepted pilots is $5,000. It does not submit the buyer's request, accept terms, promise qualification, or create checkout. EnergyAI reviews scope, source material, delivery capacity, and commercial terms before requesting payment.
MCP tool call — qualify facts, then hand off safely
get_power_passport_link({
  "siteLocation": "Clark County, Nevada",
  "targetMw": 12,
  "workloadType": "inference",
  "projectStage": "utility_conversations",
  "decisionNeed": "Decide whether to stage the first 4 MW here or continue the site search."
})

Power Screen — the agent-to-agent purchase

Call get_power_service_quote for free to bind one scenario to an exact, signed, 15-minute quote. Then call run_power_screen for $1 using prepaid credit. The completed artifact separates buyer-supplied facts, modeled signals, and missing evidence; failed executions automatically restore the debit. It is a planning screen, not a utility or engineering finding.
MCP tool calls — quote first, then execute
const quote = get_power_service_quote({
  "siteLocation": "Clark County, Nevada",
  "targetMw": 12,
  "workloadType": "inference",
  "flexibilityHours": 24,
  "stagedMw": 4,
  "coolingMode": "dry",
  "powerEvidence": "utility_contact"
})

run_power_screen({ "quoteToken": quote.quote.quoteToken })

Why EnergyAI

EnergyAI keeps supplied facts, modeled estimates and missing evidence visible. Quote terms are checked against the submitted text; sources and assumptions travel with the result. Your agent can deliver that result in the conversation, and the household can choose to keep a private decision record. A tool call alone does not establish savings or a successful installation.

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 →

By creating a key, you agree to the Terms and Privacy Policy.