com.energyaisolution/energyai

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Solar, weatherization, EV charging, battery and heat-pump decision tools for AI agents.

Measured statistics

Add to your agent

Copy this into your MCP client config:

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

Measured tools (30)

• 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]

  Parameters:

  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • country — string — ISO 3166-1 alpha-2 country code. Omit for US. Any country works — non-US results return qualitative, officially-sourced incentive guidance (never US federal credits).
  • zipCode — string — Postal code of the property. US: 5-digit ZIP (ZIP+4 accepted). Other countries: your local postal code (pass country too). Omit entirely for national-level guidance.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • country — string — ISO 3166-1 alpha-2 country code. Omit for US. Non-US estimates use a default solar resource and say so honestly.
  • zipCode — string — Optional postal code of the property. US: 5-digit ZIP. Other countries: your local postal code (pass country too). Omit it to use documented national assumptions.
  • systemKw — number — Proposed solar system size in kW-DC. Omit to have a size recommended from the bill.
  • monthlyBillUsd — number — Average monthly electric bill in USD (used to size a system when systemKw is omitted).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • evType — string — e.g. own_ev | plan_ev | no_ev
  • country — string — ISO 3166-1 alpha-2 country code. Omit for US.
  • roofAge — string — e.g. lt_5 | 5_15 | gt_15 | unknown
  • zipCode — string — Optional postal code of the property. US: 5-digit ZIP. Other countries: local postal code (pass country too). Omit it to use documented national assumptions.
  • backupNeed — string — e.g. whole_home | essentials | none
  • heatingFuel — string — e.g. natural_gas | oil | propane | electric_resistance | heat_pump | wood | other
  • serviceType — string — Primary interest: solar | battery | ev_charger | efficiency | heat_pump | unsure
  • propertyType — string — single_family | townhouse | condo | mobile_home | multi_family | commercial | farm | other
  • outageConcern — string — rare | occasional | frequent | severe
  • monthlyBillUsd — number — Alternative to monthlyBillRange: average monthly bill in USD.
  • monthlyBillRange — string — lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown
  • electricalPanelSize — string — e.g. lt_100 | 100_200 | gt_200 | unknown

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_quote_link

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

  Parameters:

  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • country — string — ISO 3166-1 alpha-2 country code. Omit for US.
  • zipCode — string — Postal code of the property. US: 5-digit ZIP (ZIP+4 accepted). Other countries: local postal code (pass country too). Omit if unknown — the assessment collects it.
  • contractorCategory — string — Optional: solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump. Pre-selects the project type; omit if unknown.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_power_passport_link

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

  Parameters:

  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • targetMw — number — Target compute or flexible-load capacity in MW.
  • decisionNeed — string — The concrete decision this five-day pre-feasibility screen must change. Do not include personal or confidential information.
  • projectStage — string — Current project stage.
  • siteLocation — string — Broad candidate-site description such as county/state, balancing area, or approximate coordinates. Do not send a street address or contact information.
  • workloadType — string — Primary workload or renewable-project use case.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • siteLocation (required) — string — County/state, balancing area, or approximate site. Do not send a street address or contact information.
  • targetMw (required) — number — Target compute or flexible-load capacity in MW.
  • workloadType (required) — string
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • stagedMw — number — Optional first-stage load in MW; defaults to the lesser of 4 MW and targetMw.
  • coolingMode — string
  • storageHours — number — Optional available storage duration in hours.
  • powerEvidence — string — Buyer-stated evidence maturity; confirmed still requires documentary verification.
  • flexibilityHours — number — Hours per week the workload can shift.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • contractorCategory (required) — string — solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump
  • zipCode (required) — string — 5-digit US ZIP code of the project (route_lead dispatches into a US installer network only today).
  • contactName (required) — string — Homeowner's name.
  • contactEmail (required) — string — Homeowner's email.
  • consentText (required) — string — 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.
  • consentTimestamp (required) — string — When the homeowner consented.
  • city — string
  • state — string — Two-letter state code. Derived from ZIP when omitted.
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • timeline — string — e.g. asap | 3_months | 6_months | exploring
  • budgetRange — string
  • contactPhone — string
  • propertyType — string
  • consentVersion — string — Required when consentText is not the canonical EnergyAI consent text.
  • monthlyBillRange — string — lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • limit — number — Max guides to return (1–50, default 20).
  • topic — string — Filter by topic: solar | heat_pump | battery | weatherization | overview. Omit for all topics.
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • region — string — Filter by region: full state name (e.g. 'Vermont'), two-letter code (e.g. 'VT'), or 'United States' for federal-level guides. Omit for all regions.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • slug (required) — string — Guide slug exactly as returned by list_guides (e.g. 'vermont-solar-incentives-2026').
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • name (required) — string — Name of the agent, product, or operator claiming the key (2-120 chars). Shown only on your own account.
  • acceptTerms (required) — boolean — Must be true, and only after the human operator has authorized acceptance of the EnergyAI Terms and Privacy Policy. If authorization is not already documented, call get_builder_upgrade_link and surface its one-screen activation URL instead.
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • intendedUse — string — OPTIONAL, one line: what you plan to build. Used only to prioritize the roadmap.
  • contactEmail — string — OPTIONAL. Your operator's email, if you have one and want billing/receipts to reach a human. Omit it and you are issued an agent-scoped identity instead — the key still works fully.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • mode — string — 'subscription' (default) for the $19/month Builder plan, or 'credit' for a one-off prepaid top-up.
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • amountCents — number — Only for mode=credit: top-up amount in cents (minimum 500, default 2000).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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]

  Parameters:

  • state — string — Two-letter US state code. Use instead of zipCode for a statewide list.
  • apiKey — string — Optional existing EnergyAI key for hosts that cannot change Authorization headers. Use it to retain account identity for discovery and get_builder_upgrade_link after a trial. Removed before tool execution and persistence. Omit when the Bearer header is attached; never show the key to the user.
  • zipCode — string — 5-digit US ZIP of the property (ZIP+4 accepted). US-only today.
  • contractorCategory — string — Optional filter: solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• run_power_screen

  Execute one signed Power Screen quote and return an immediate modeled constraint decision, assumptions, evidence gaps, and immutable artifact hash. [$1.00/call]

  Parameters:

  • quoteToken (required) — string — Unmodified signed quoteToken returned by get_power_service_quote. The quote expires after 15 minutes and binds scope, price, and assumptions.
  • apiKey — string — Optional one-call credential bridge for MCP hosts that cannot change Authorization headers mid-session. EnergyAI strips it before billing, execution, and persistence.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• bootstrap_energy_project

  Create a persisted project context, provisional Energy Node score, coverage map, and immediately reusable assessmentId in one call. [$0.10/call]

  Parameters:

  • postalCode (required) — string — Property ZIP or local postal code.
  • city — string
  • state — string
  • apiKey — string — Optional one-call credential bridge for MCP hosts that cannot change Authorization headers mid-session. Pass the key returned by create_builder_key; EnergyAI removes it from the request body before billing, execution, and persistence. Omit when the Bearer header is already attached.
  • country — string
  • primaryGoal — string
  • serviceType — string
  • propertyType — string
  • monthlyBillRange — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_energy_assessment

  Start a new assessment session. Free. [free]

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• answer_energy_assessment_question

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

  Parameters:

  • assessmentId (required) — string
  • questionKey (required) — string
  • answerValue (required) — string
  • answerLabel — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• complete_energy_assessment

  Finalize an assessment and trigger the recommendation workflow. Free. [free]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• generate_energy_recommendation_preview

  Generate honest cost, savings, and next-action ranges. [$0.05/call]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_energy_node_score

  Retrieve the persisted seven-axis score with input coverage, weakest-axis gaps, next action, and calculation provenance. [$0.05/call]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_energy_node_roadmap_checkout

  Create the end-user checkout link for an unlocked Energy Node roadmap. Free. [free]

  Parameters:

  • assessmentId (required) — string
  • email — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_energy_node_roadmap

  Retrieve the full unlocked Energy Node roadmap. Locked previews never consume credit. [$0.10/call]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• generate_intelligence_bound_report

  Generate a property-specific dI/dt analysis. [$0.25/call]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_information_theoretic_recommendation

  Rank upgrades by intelligence-bound lift per dollar. [$0.25/call]

  Parameters:

  • assessmentId (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_eta_i_metric

  Read the public platform intelligence-efficiency metric. Free. [free]

  Parameters:

  • days — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_anonymized_dataset_sample

  Return an aggregated, anonymized Energy Node dataset sample. [$1.00/call]

  Parameters:

  • limit — number
  • offset — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• match_installers

  Return up to three eligible installer matches for a region. [$0.05/call]

  Parameters:

  • contractorCategory (required) — string
  • zipCode (required) — string
  • state — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_energy_incentives

  Use a completed assessment to prioritize property-specific incentive checks and return an evidence-based verification plan. [$0.02/call]

  Parameters:

  • assessmentId (required) — string — Completed EnergyAI assessment id. Use free check_incentives for ZIP-only guidance.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• review_installer_quote

  Return 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/call]

  Parameters:

  • quoteText (required) — string — Redacted installer quote text. Exclude names, contact details, street addresses and account/proposal identifiers. Returns source-matched questions; no independent verification or human review.
  • city — string
  • state — string
  • apiKey — string — Optional one-call credential bridge for MCP hosts that cannot change Authorization headers mid-session. Pass the key returned by create_builder_key; EnergyAI strips it before billing, execution, and persistence.
  • country — string
  • postalCode — string — Property ZIP or local postal code. Required when assessmentId is omitted.
  • serviceType — string
  • assessmentId — string — Optional existing EnergyAI assessment id. Omit when supplying postalCode for automatic project creation.
  • propertyType — string
  • monthlyBillRange — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• record_quote_review_outcome

  Record actual operator-confirmed usefulness and household delivery status for your completed quote review. Requires your Builder key. Free; never infer feedback from a successful tool call. [free]

  Parameters:

  • reviewToolCallId (required) — string — toolCallId of the completed review owned by this key.
  • operatorConfirmed (required) — boolean — True only after the operator actually assessed this result.
  • usefulness (required) — string
  • findingId (required) — ['string', 'null'] — A returned q1–q6 check id, or null when not useful.
  • deliveredToHousehold (required) — boolean
  • action (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• submit_contractor_match_request

  Submit a consented installer lead and retain referral attribution. Free. [free]

  Parameters:

  • assessmentId (required) — string
  • contactName (required) — string
  • contactEmail (required) — string
  • consentText (required) — string — EXACT consent text shown to end user.
  • consentTimestamp (required) — string
  • contactPhone — string
  • consentVersion — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.