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]

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "59715"
    },
    {
      "country": "DE",
      "zipCode": "10115"
    }
  ],
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "examples": [
        "DE",
        "GB",
        "CA"
      ],
      "description": "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": {
      "type": "string",
      "examples": [
        "59715"
      ],
      "description": "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."
    }
  }
}

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]

Argument	Type	Description
name*	string	Name of the agent, product, or operator claiming the key (2-120 chars). Shown only on your own account.
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.
acceptTerms*	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.
intendedUse	string	OPTIONAL, one line: what you plan to build. Used only to prioritize the roadmap.

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]

Argument	Type	Description
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).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "59715",
      "systemKw": 6
    },
    {
      "zipCode": "02139",
      "monthlyBillUsd": 180
    }
  ],
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "examples": [
        "AU",
        "DE"
      ],
      "description": "ISO 3166-1 alpha-2 country code. Omit for US. Non-US estimates use a default solar resource and say so honestly."
    },
    "zipCode": {
      "type": "string",
      "examples": [
        "59715"
      ],
      "description": "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": {
      "type": "number",
      "examples": [
        6
      ],
      "description": "Proposed solar system size in kW-DC. Omit to have a size recommended from the bill."
    },
    "monthlyBillUsd": {
      "type": "number",
      "examples": [
        180
      ],
      "description": "Average monthly electric bill in USD (used to size a system when systemKw is omitted)."
    }
  }
}

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]

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "05401"
    },
    {
      "state": "VT",
      "contractorCategory": "solar_installation"
    }
  ],
  "required": [],
  "properties": {
    "state": {
      "type": "string",
      "examples": [
        "VT",
        "CA"
      ],
      "description": "Two-letter US state code. Use instead of zipCode for a statewide list."
    },
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "examples": [
        "59715"
      ],
      "description": "5-digit US ZIP of the property (ZIP+4 accepted). US-only today."
    },
    "contractorCategory": {
      "type": "string",
      "description": "Optional filter: solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump"
    }
  }
}

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]

Argument	Type	Description
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).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {},
    {
      "mode": "subscription"
    },
    {
      "mode": "credit",
      "amountCents": 2000
    }
  ],
  "required": [],
  "properties": {
    "mode": {
      "type": "string",
      "description": "'subscription' (default) for the $19/month Builder plan, or 'credit' for a one-off prepaid top-up."
    },
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "number",
      "examples": [
        2000
      ],
      "description": "Only for mode=credit: top-up amount in cents (minimum 500, default 2000)."
    }
  }
}

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]

Argument	Type	Description
slug*	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.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Guide slug exactly as returned by list_guides (e.g. 'vermont-solar-incentives-2026')."
    },
    "apiKey": {
      "type": "string",
      "description": "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."
    }
  }
}

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]

Argument	Type	Description
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

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]

Argument	Type	Description
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.

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]

Argument	Type	Description
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.
targetMw*	number	Target compute or flexible-load capacity in MW.
coolingMode	string
siteLocation*	string	County/state, balancing area, or approximate site. Do not send a street address or contact information.
storageHours	number	Optional available storage duration in hours.
workloadType*	string

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]

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "59715"
    },
    {
      "zipCode": "59715",
      "contractorCategory": "solar_installation"
    },
    {}
  ],
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "examples": [
        "DE",
        "GB"
      ],
      "description": "ISO 3166-1 alpha-2 country code. Omit for US."
    },
    "zipCode": {
      "type": "string",
      "examples": [
        "59715",
        "59715-1234"
      ],
      "description": "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": {
      "type": "string",
      "description": "Optional: solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump. Pre-selects the project type; omit if unknown."
    }
  }
}

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]

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max guides to return (1–50, default 20)."
    },
    "topic": {
      "type": "string",
      "description": "Filter by topic: solar | heat_pump | battery | weatherization | overview. Omit for all topics."
    },
    "apiKey": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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."
    }
  }
}

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]

Argument	Type	Description
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.
zipCode*	string	5-digit US ZIP code of the project (route_lead dispatches into a US installer network only today).
timeline	string	e.g. asap \| 3_months \| 6_months \| exploring
budgetRange	string
consentText*	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.

Solar Home Incentives

Try it

check_incentives

Solar Home Incentives

Try it

check_incentives

Tools (12)