Solar Quote Audit — Check Before You Sign

Analyze a residential solar proposal for clarity and completeness before a homeowner signs. Accepts the pricing, financing, system/battery, and installer details from a quote and returns a structured second-opinion review: a Quote Clarity Score (0-100) across four dimensions (Price Transparency /25, Financing & Contract Clarity /30, System & Battery Evidence /25, Installer & Protection Readiness /20), an overall rating, plain-language red flags, missing information, specific questions to ask the installer, and a recommended next step. Illustrative educational decision support only — not legal, tax, financial, or engineering advice, does not guarantee savings or system performance, does not endorse any installer, and takes no consequential action.

{
  "type": "object",
  "properties": {
    "cashPrice": {
      "type": "number",
      "description": "Total cash price for the system in USD."
    },
    "financedPrice": {
      "type": "number",
      "description": "Total financed price in USD, if different from cash."
    },
    "systemSizeKw": {
      "type": "number",
      "description": "System size in kilowatts (kW)."
    },
    "panelCount": {
      "type": "number",
      "description": "Number of solar panels."
    },
    "panelModel": {
      "type": "string",
      "description": "Solar panel brand and model."
    },
    "annualProductionEstimate": {
      "type": "number",
      "description": "Quoted annual production estimate in kWh."
    },
    "annualUsageAvailable": {
      "type": "boolean",
      "description": "True if the installer confirmed sizing against your actual annual kWh usage."
    },
    "batteryIncluded": {
      "type": "boolean",
      "description": "True if a battery is included in the proposal."
    },
    "batteryModel": {
      "type": "string",
      "description": "Battery brand and model."
    },
    "batteryCount": {
      "type": "number",
      "description": "Number of battery units."
    },
    "batteryUsableCapacityKwh": {
      "type": "number",
      "description": "Battery usable capacity in kWh."
    },
    "batteryPriceSeparate": {
      "type": "number",
      "description": "Battery cost as a separate line item in USD."
    },
    "roofingCost": {
      "type": "number",
      "description": "Roofing add-on cost in USD."
    },
    "panelUpgradeCost": {
      "type": "number",
      "description": "Electrical panel upgrade cost in USD."
    },
    "otherAddonsCost": {
      "type": "number",
      "description": "Other itemized add-on costs in USD."
    },
    "financeType": {
      "type": "string",
      "enum": [
        "cash",
        "loan",
        "lease",
        "ppa",
        "prepaid_lease"
      ],
      "description": "How the system is paid for."
    },
    "apr": {
      "type": "number",
      "description": "Annual percentage rate for financing."
    },
    "termYears": {
      "type": "number",
      "description": "Financing term in years."
    },
    "monthlyPayment": {
      "type": "number",
      "description": "Monthly payment in USD."
    },
    "downPayment": {
      "type": "number",
      "description": "Down payment in USD."
    },
    "escalatorPct": {
      "type": "number",
      "description": "Annual payment escalator percentage (0 if none)."
    },
    "totalPayments": {
      "type": "number",
      "description": "Total of all payments over the term in USD."
    },
    "earlyPayoffTermsShown": {
      "type": "boolean",
      "description": "True if early payoff terms are disclosed."
    },
    "buyoutLanguageShown": {
      "type": "boolean",
      "description": "True if lease/PPA buyout language is present."
    },
    "transferLanguageShown": {
      "type": "boolean",
      "description": "True if contract transfer terms are disclosed."
    },
    "installerName": {
      "type": "string",
      "description": "Installer company name."
    },
    "licenseNumber": {
      "type": "string",
      "description": "Contractor (CSLB) license number."
    },
    "installerAddressShown": {
      "type": "boolean",
      "description": "True if a physical installer address is shown."
    },
    "crewType": {
      "type": "string",
      "enum": [
        "w2",
        "subcontractor",
        "unknown"
      ],
      "description": "Installation crew model."
    },
    "workmanshipWarrantyYears": {
      "type": "number",
      "description": "Workmanship warranty duration in years."
    },
    "roofPenetrationWarranty": {
      "type": "boolean",
      "description": "True if a roof penetration warranty is stated."
    },
    "warrantyRegistrationExplained": {
      "type": "boolean",
      "description": "True if warranty registration is explained."
    },
    "bondInsuranceShown": {
      "type": "boolean",
      "description": "True if bond/insurance documentation is shown."
    },
    "ptoResponsibilityShown": {
      "type": "boolean",
      "description": "True if PTO/interconnection responsibility is stated."
    },
    "installTimelineShown": {
      "type": "boolean",
      "description": "True if an install timeline is shown."
    },
    "cancellationInfoShown": {
      "type": "boolean",
      "description": "True if cancellation/rescission rights are shown."
    }
  },
  "description": "Fields extracted from a residential solar proposal. All fields are optional — the tool scores clarity based on what is present and flags what is missing. Provide numbers without currency or percent symbols.",
  "additionalProperties": false
}

Return the fixed, published scoring methodology used by the Solar Quote Audit: the four scoring dimensions, their point weights, the individual rules within each dimension, and the rating thresholds. Takes no arguments.

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

Return the California city editions the Solar Quote Audit supports, including each city name and its primary electric utility. Takes no arguments.

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