Servers Playground How we check Add a server Log in

Energyai

Working · 1.9 s

com.energyaisolution/energyaiv1.3.0 Domain verified

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

Local Services Legal & Government

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.energyaisolution.com/mcp

Authorization (optional)

Optional Bearer key. Start with 20 anonymous informational calls/24h; free key: 100/30d. Operator-authorized activation includes three eligible commercial trials on the full endpoint. Builder: $19/month with $20 tool credit. Live pricing and supported jobs: /agents.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

answer_energy_assessment_question

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

answerValuestring, required

questionKeystring, required

assessmentIdstring, required

answerLabelstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Energyai MCP server | mcptry

Tools (30)

answer_energy_assessment_question

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

Argument	Type	Description
answerLabel	string
answerValue*	string
questionKey*	string
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId",
    "questionKey",
    "answerValue"
  ],
  "properties": {
    "answerLabel": {
      "type": "string"
    },
    "answerValue": {
      "type": "string"
    },
    "questionKey": {
      "type": "string"
    },
    "assessmentId": {
      "type": "string"
    }
  }
}

bootstrap_energy_project

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

Argument	Type	Description
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
postalCode*	string	Property ZIP or local postal code.
primaryGoal	string
serviceType	string
propertyType	string
monthlyBillRange	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "postalCode"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "apiKey": {
      "type": "string",
      "description": "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": {
      "enum": [
        "US",
        "CA",
        "GB",
        "DE",
        "AU",
        "OTHER"
      ],
      "type": "string",
      "default": "US"
    },
    "postalCode": {
      "type": "string",
      "description": "Property ZIP or local postal code."
    },
    "primaryGoal": {
      "enum": [
        "save_money",
        "resilience",
        "climate",
        "independence",
        "all"
      ],
      "type": "string",
      "default": "save_money"
    },
    "serviceType": {
      "enum": [
        "solar",
        "battery",
        "ev_charger",
        "efficiency",
        "heat_pump",
        "unsure"
      ],
      "type": "string",
      "default": "unsure"
    },
    "propertyType": {
      "enum": [
        "single_family",
        "townhouse",
        "condo",
        "rental",
        "commercial",
        "farm",
        "other"
      ],
      "type": "string",
      "default": "other"
    },
    "monthlyBillRange": {
      "enum": [
        "lt_75",
        "75_150",
        "150_250",
        "250_400",
        "gt_400",
        "unknown"
      ],
      "type": "string",
      "default": "unknown"
    }
  }
}

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."
    }
  }
}

complete_energy_assessment

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

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.

create_energy_assessment

Start a new assessment session. Free. [free]

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

create_energy_node_roadmap_checkout

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

Argument	Type	Description
email	string
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email"
    },
    "assessmentId": {
      "type": "string"
    }
  }
}

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"
    }
  }
}

generate_energy_recommendation_preview

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

generate_intelligence_bound_report

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

get_anonymized_dataset_sample

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

Argument	Type	Description
limit	number
offset	number

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 100
    },
    "offset": {
      "type": "number",
      "default": 0
    }
  }
}

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_energy_incentives

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

Argument	Type	Description
assessmentId*	string	Completed EnergyAI assessment id. Use free check_incentives for ZIP-only guidance.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string",
      "description": "Completed EnergyAI assessment id. Use free check_incentives for ZIP-only guidance."
    }
  }
}

get_energy_node_roadmap

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

get_energy_node_score

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

get_eta_i_metric

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

Argument	Type	Description
days	number

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "default": 30
    }
  }
}

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_information_theoretic_recommendation

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

Argument	Type	Description
assessmentId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId"
  ],
  "properties": {
    "assessmentId": {
      "type": "string"
    }
  }
}

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."
    }
  }
}

match_installers

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

Argument	Type	Description
state	string
zipCode*	string
contractorCategory*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "contractorCategory",
    "zipCode"
  ],
  "properties": {
    "state": {
      "type": "string"
    },
    "zipCode": {
      "type": "string"
    },
    "contractorCategory": {
      "type": "string"
    }
  }
}

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]

Argument	Type	Description
action*	string
findingId*	string \| null	A returned q1–q6 check id, or null when not useful.
usefulness*	string
reviewToolCallId*	string	toolCallId of the completed review owned by this key.
operatorConfirmed*	boolean	True only after the operator actually assessed this result.
deliveredToHousehold*	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "reviewToolCallId",
    "operatorConfirmed",
    "usefulness",
    "findingId",
    "deliveredToHousehold",
    "action"
  ],
  "properties": {
    "action": {
      "enum": [
        "asked_installer",
        "requested_revision",
        "compared_alternatives",
        "decided_to_proceed",
        "decided_to_pause",
        "no_action_yet"
      ],
      "type": "string"
    },
    "findingId": {
      "type": [
        "string",
        "null"
      ],
      "description": "A returned q1–q6 check id, or null when not useful."
    },
    "usefulness": {
      "enum": [
        "useful",
        "partly_useful",
        "not_useful"
      ],
      "type": "string"
    },
    "reviewToolCallId": {
      "type": "string",
      "description": "toolCallId of the completed review owned by this key."
    },
    "operatorConfirmed": {
      "type": "boolean",
      "const": true,
      "description": "True only after the operator actually assessed this result."
    },
    "deliveredToHousehold": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

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]

Argument	Type	Description
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
quoteText*	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.
postalCode	string	Property ZIP or local postal code. Required when assessmentId is omitted.
serviceType	string
assessmentId	string

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.

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]

Argument	Type	Description
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.
quoteToken*	string	Unmodified signed quoteToken returned by get_power_service_quote. The quote expires after 15 minutes and binds scope, price, and assumptions.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "quoteToken"
  ],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Optional one-call credential bridge for MCP hosts that cannot change Authorization headers mid-session. EnergyAI strips it before billing, execution, and persistence."
    },
    "quoteToken": {
      "type": "string",
      "description": "Unmodified signed quoteToken returned by get_power_service_quote. The quote expires after 15 minutes and binds scope, price, and assumptions."
    }
  }
}

submit_contractor_match_request

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

Argument	Type	Description
consentText*	string	EXACT consent text shown to end user.
contactName*	string
assessmentId*	string
contactEmail*	string
contactPhone	string
consentVersion	string
consentTimestamp*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "assessmentId",
    "contactName",
    "contactEmail",
    "consentText",
    "consentTimestamp"
  ],
  "properties": {
    "consentText": {
      "type": "string",
      "description": "EXACT consent text shown to end user."
    },
    "contactName": {
      "type": "string"
    },
    "assessmentId": {
      "type": "string"
    },
    "contactEmail": {
      "type": "string",
      "format": "email"
    },
    "contactPhone": {
      "type": "string"
    },
    "consentVersion": {
      "type": "string"
    },
    "consentTimestamp": {
      "type": "string",
      "format": "date-time"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "59715",
      "heatingFuel": "natural_gas",
      "serviceType": "solar",
      "propertyType": "single_family",
      "monthlyBillRange": "150_250"
    }
  ],
  "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."
    },
    "evType": {
      "type": "string",
      "description": "e.g. own_ev | plan_ev | no_ev"
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code. Omit for US."
    },
    "roofAge": {
      "type": "string",
      "description": "e.g. lt_5 | 5_15 | gt_15 | unknown"
    },
    "zipCode": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "e.g. whole_home | essentials | none"
    },
    "heatingFuel": {
      "type": "string",
      "description": "e.g. natural_gas | oil | propane | electric_resistance | heat_pump | wood | other"
    },
    "serviceType": {
      "type": "string",
      "description": "Primary interest: solar | battery | ev_charger | efficiency | heat_pump | unsure"
    },
    "propertyType": {
      "type": "string",
      "description": "single_family | townhouse | condo | mobile_home | multi_family | commercial | farm | other"
    },
    "outageConcern": {
      "type": "string",
      "description": "rare | occasional | frequent | severe"
    },
    "monthlyBillUsd": {
      "type": "number",
      "description": "Alternative to monthlyBillRange: average monthly bill in USD."
    },
    "monthlyBillRange": {
      "type": "string",
      "description": "lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown"
    },
    "electricalPanelSize": {
      "type": "string",
      "description": "e.g. lt_100 | 100_200 | gt_200 | unknown"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "stagedMw": 4,
      "targetMw": 12,
      "coolingMode": "dry",
      "siteLocation": "Clark County, Nevada",
      "storageHours": 2,
      "workloadType": "inference",
      "powerEvidence": "utility_contact",
      "flexibilityHours": 24
    }
  ],
  "required": [
    "siteLocation",
    "targetMw",
    "workloadType"
  ],
  "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."
    },
    "stagedMw": {
      "type": "number",
      "maximum": 2000,
      "minimum": 0.1,
      "description": "Optional first-stage load in MW; defaults to the lesser of 4 MW and targetMw."
    },
    "targetMw": {
      "type": "number",
      "maximum": 2000,
      "minimum": 0.1,
      "description": "Target compute or flexible-load capacity in MW."
    },
    "coolingMode": {
      "enum": [
        "unknown",
        "dry",
        "liquid_closed",
        "evaporative"
      ],
      "type": "string",
      "default": "unknown"
    },
    "siteLocation": {
      "type": "string",
      "description": "County/state, balancing area, or approximate site. Do not send a street address or contact information."
    },
    "storageHours": {
      "type": "number",
      "maximum": 24,
      "minimum": 0,
      "description": "Optional available storage duration in hours."
    },
    "workloadType": {
      "enum": [
        "ai_training",
        "inference",
        "hpc",
        "rendering_simulation",
        "mixed_compute",
        "renewable_project",
        "other"
      ],
      "type": "string"
    },
    "powerEvidence": {
      "enum": [
        "unknown",
        "regional",
        "utility_contact",
        "confirmed"
      ],
      "type": "string",
      "default": "unknown",
      "description": "Buyer-stated evidence maturity; confirmed still requires documentary verification."
    },
    "flexibilityHours": {
      "type": "number",
      "maximum": 168,
      "minimum": 0,
      "description": "Hours per week the workload can shift."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "assessmentId"
      ]
    },
    {
      "required": [
        "postalCode"
      ]
    }
  ],
  "required": [
    "quoteText"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "apiKey": {
      "type": "string",
      "description": "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": {
      "enum": [
        "US",
        "CA",
        "GB",
        "DE",
        "AU",
        "OTHER"
      ],
      "type": "string",
      "default": "US"
    },
    "quoteText": {
      "type": "string",
      "maxLength": 6000,
      "description": "Redacted installer quote text. Exclude names, contact details, street addresses and account/proposal identifiers. Returns source-matched questions; no independent verification or human review."
    },
    "postalCode": {
      "type": "string",
      "description": "Property ZIP or local postal code. Required when assessmentId is omitted."
    },
    "serviceType": {
      "enum": [
        "solar",
        "battery",
        "ev_charger",
        "efficiency",
        "heat_pump",
        "unsure"
      ],
      "type": "string",
      "default": "solar"
    },
    "assessmentId": {
      "type": "string",
      "description": "Optional existing EnergyAI assessment id. Omit when supplying postalCode for automatic project creation."
    },
    "propertyType": {
      "enum": [
        "single_family",
        "townhouse",
        "condo",
        "rental",
        "commercial",
        "farm",
        "other"
      ],
      "type": "string",
      "default": "other"
    },
    "monthlyBillRange": {
      "enum": [
        "lt_75",
        "75_150",
        "150_250",
        "250_400",
        "gt_400",
        "unknown"
      ],
      "type": "string",
      "default": "unknown"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "zipCode": "59715",
      "timeline": "3_months",
      "consentText": "<canonical text returned by check_incentives.consentTextForRouting, shown to and accepted by the homeowner>",
      "contactName": "Jane Doe",
      "contactEmail": "[email protected]",
      "consentTimestamp": "2026-07-12T19:00:00Z",
      "monthlyBillRange": "150_250",
      "contractorCategory": "solar_installation"
    }
  ],
  "required": [
    "contractorCategory",
    "zipCode",
    "contactName",
    "contactEmail",
    "consentText",
    "consentTimestamp"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code. Derived from ZIP when omitted."
    },
    "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",
      "description": "5-digit US ZIP code of the project (route_lead dispatches into a US installer network only today)."
    },
    "timeline": {
      "type": "string",
      "description": "e.g. asap | 3_months | 6_months | exploring"
    },
    "budgetRange": {
      "type": "string"
    },
    "consentText": {
      "type": "string",
      "description": "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."
    },
    "contactName": {
      "type": "string",
      "description": "Homeowner's name."
    },
    "contactEmail": {
      "type": "string",
      "format": "email",
      "description": "Homeowner's email."
    },
    "contactPhone": {
      "type": "string"
    },
    "propertyType": {
      "type": "string"
    },
    "consentVersion": {
      "type": "string",
      "description": "Required when consentText is not the canonical EnergyAI consent text."
    },
    "consentTimestamp": {
      "type": "string",
      "format": "date-time",
      "description": "When the homeowner consented."
    },
    "monthlyBillRange": {
      "type": "string",
      "description": "lt_75 | 75_150 | 150_250 | 250_400 | gt_400 | unknown"
    },
    "contractorCategory": {
      "type": "string",
      "description": "solar_installation | battery_storage | ev_charger | energy_audit | insulation_weatherization | heat_pump"
    }
  }
}