{
  "title": "Solar payback calculator",
  "human_url": "https://happytails.ai/en/calculators/solar-payback-calculator/",
  "agent_url": "https://happytails.ai/agents/en/calculators/solar-payback-calculator/",
  "language": "en",
  "markdown_url": "https://happytails.ai/en/calculators/solar-payback-calculator.md",
  "content": "Solar payback calculator\nExplore undiscounted solar electricity value and payback from your generation, self-consumption, import/export prices, degradation and tariff-change assumptions.\nHow to use Solar payback calculator\nEnter installed cost and estimated first-year generation.\nEnter the self-consumption share and your import and export prices; use an explicit 0 for a price you exclude.\nChoose annual degradation, a common import/export price-change assumption and the horizon.\nReview year-zero outlay, annual value, cumulative cash flow and nullable payback, then export JSON and CSV.\nHow can we improve this tool?\nReport a problem or share an idea.\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\nUseful next steps\nAppliance electricity cost calculator\nHot water energy calculator\nInsulation calculator\nValue of generated electricity\nSelf-consumed generation avoids your marginal import energy price. The remainder earns the export payment you enter. Standing charges are not automatically avoided. Prices use one currency, with no tariff, subsidy or tax database.\nA scenario, not a financial promise\nDegradation and price changes compound from year two. The self-consumption share remains fixed, and both import and export prices use the same escalation rate. Costs for finance, maintenance, replacements and tax are excluded; cash flows are not discounted.\nTwo payback measures\nSimple payback divides installation cost by positive first-year electricity value. Cumulative payback finds the first cost crossing in the horizon and interpolates evenly within that year. No crossing is reported as not defined. Zero installation cost has payback zero. The year-zero row records the installation outflow; display rounding occurs after calculations.",
  "content_format": "text/plain",
  "visibility": "public",
  "links": [
    {
      "name": "Appliance electricity cost calculator",
      "url": "https://happytails.ai/en/calculators/appliance-electricity-cost-calculator/"
    },
    {
      "name": "Hot water energy calculator",
      "url": "https://happytails.ai/en/calculators/hot-water-energy-calculator/"
    },
    {
      "name": "Insulation calculator",
      "url": "https://happytails.ai/en/calculators/insulation-calculator/"
    }
  ],
  "tool": {
    "id": "solar-payback-calculator",
    "category": "calculators",
    "built": true,
    "requirements": "Installed cost 0 to 1 trillion in one currency; first-year generation 0 to 1 billion kWh; self-consumption 0 to 100%; prices explicitly entered from 0 to 100,000 per kWh. Degradation 0 to 99%; annual price change -99 to 100%; horizon 1 to 100 whole years. Extreme combinations outside the shared finite-output limit are rejected. JSON report, results CSV and full year-zero-through-horizon cash-flow CSV.",
    "implementation": {
      "fields": [
        {
          "key": "installedCost",
          "label": "Installed cost",
          "value": 6000,
          "type": "number",
          "min": 0,
          "max": 1000000000000,
          "step": "any"
        },
        {
          "key": "generation",
          "label": "First-year generation (kWh)",
          "value": 4000,
          "type": "number",
          "min": 0,
          "max": 1000000000,
          "step": "any"
        },
        {
          "key": "selfConsumption",
          "label": "Generation used on site (%)",
          "value": 50,
          "type": "number",
          "min": 0,
          "max": 100,
          "step": "any"
        },
        {
          "key": "importTariff",
          "label": "Avoided import price per kWh",
          "value": "",
          "type": "number",
          "min": 0,
          "max": 100000,
          "step": "any",
          "help": "Required. Use the marginal energy price avoided, not a standing charge. Enter 0 explicitly if excluded."
        },
        {
          "key": "exportTariff",
          "label": "Export payment per kWh",
          "value": "",
          "type": "number",
          "min": 0,
          "max": 100000,
          "step": "any",
          "help": "Required. Enter your export payment, or 0 explicitly if exports have no value."
        },
        {
          "key": "degradation",
          "label": "Annual generation degradation (%)",
          "value": 0,
          "type": "number",
          "min": 0,
          "max": 99,
          "step": "any"
        },
        {
          "key": "escalation",
          "label": "Annual import and export price change (%)",
          "value": 0,
          "type": "number",
          "min": -99,
          "max": 100,
          "step": "any"
        },
        {
          "key": "years",
          "label": "Scenario horizon (years)",
          "value": 25,
          "type": "number",
          "min": 0,
          "max": 100,
          "step": 1
        }
      ],
      "registrationFamily": "home-energy-planning",
      "input": false,
      "live": false,
      "presentation": "metrics",
      "note": "Calculated on your device for 1 to 100 years. Enter your own import/export prices. Cash flows are undiscounted scenarios, with no tax, subsidy, finance or return guarantee.",
      "experience": {
        "automatic": false,
        "single": true,
        "inputMaxLength": 1000000,
        "inputMode": "text",
        "label": "Solar value settings",
        "placeholder": "Use the fields below",
        "help": "Enter installation cost, generation, prices and scenario assumptions in the settings. No text input is needed. Up to 1,000,000 characters. Review the settings before running.",
        "action": null
      },
      "mode": "explicit",
      "interactive": false
    },
    "execution": "Browser interface",
    "api": null,
    "browser_agent": {
      "supported": true,
      "name": "run_current_tool",
      "discovery": "WebMCP on the human page in a supporting browser",
      "verification": "See audit/API-AUDIT.md; availability is not verification"
    }
  },
  "markdown": "# Solar payback calculator\n\n- Human page: https://happytails.ai/en/calculators/solar-payback-calculator/\n- Markdown: https://happytails.ai/en/calculators/solar-payback-calculator.md\n- Structured JSON: https://happytails.ai/agents/en/calculators/solar-payback-calculator/index.json\n- Visibility: public\n\n## Tool capabilities\n\n| Property | Value |\n| --- | --- |\n| Tool ID | `solar-payback-calculator` |\n| Category | calculators |\n| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |\n| Browser execution | Use the visible action or interactive controls. |\n| Browser processing | Browser; see tool notes for network behavior. |\n| HTTP API | Not callable through HTTP. |\n| Browser-agent interface | run_current_tool |\n\n### Implementation notes\n\nCalculated on your device for 1 to 100 years. Enter your own import/export prices. Cash flows are undiscounted scenarios, with no tax, subsidy, finance or return guarantee.\n\n### Inputs and settings\n\nNo free-text input is required. Use the file inputs and/or settings below.\n\n| Setting | Meaning | Control type | Default | Constraints |\n| --- | --- | --- | --- | --- |\n| `installedCost` | Installed cost | number | 6000 | min=0 max=1000000000000 step=any |\n| `generation` | First-year generation (kWh) | number | 4000 | min=0 max=1000000000 step=any |\n| `selfConsumption` | Generation used on site (%) | number | 50 | min=0 max=100 step=any |\n| `importTariff` | Avoided import price per kWh | number | \"\" | min=0 max=100000 step=any |\n| `exportTariff` | Export payment per kWh | number | \"\" | min=0 max=100000 step=any |\n| `degradation` | Annual generation degradation (%) | number | 0 | min=0 max=99 step=any |\n| `escalation` | Annual import and export price change (%) | number | 0 | min=-99 max=100 step=any |\n| `years` | Scenario horizon (years) | number | 25 | min=0 max=100 step=1 |\n\n### Browser-agent workflow\n\n1. Open the human page in a browser that supports WebMCP.\n2. Discover the interface exposed by that page; use its actual schema.\n3. Select files on the page first when the tool requires files.\n4. Call `run_current_tool` with valid input and settings.\n5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.\n\nCalls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.\n\n### Planning specification\n\nInstalled cost 0 to 1 trillion in one currency; first-year generation 0 to 1 billion kWh; self-consumption 0 to 100%; prices explicitly entered from 0 to 100,000 per kWh. Degradation 0 to 99%; annual price change -99 to 100%; horizon 1 to 100 whole years. Extreme combinations outside the shared finite-output limit are rejected. JSON report, results CSV and full year-zero-through-horizon cash-flow CSV.\n\nThis describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.\n\n### Complete machine-readable capability record\n\n```json\n{\n  \"id\": \"solar-payback-calculator\",\n  \"category\": \"calculators\",\n  \"built\": true,\n  \"requirements\": \"Installed cost 0 to 1 trillion in one currency; first-year generation 0 to 1 billion kWh; self-consumption 0 to 100%; prices explicitly entered from 0 to 100,000 per kWh. Degradation 0 to 99%; annual price change -99 to 100%; horizon 1 to 100 whole years. Extreme combinations outside the shared finite-output limit are rejected. JSON report, results CSV and full year-zero-through-horizon cash-flow CSV.\",\n  \"implementation\": {\n    \"fields\": [\n      {\n        \"key\": \"installedCost\",\n        \"label\": \"Installed cost\",\n        \"value\": 6000,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 1000000000000,\n        \"step\": \"any\"\n      },\n      {\n        \"key\": \"generation\",\n        \"label\": \"First-year generation (kWh)\",\n        \"value\": 4000,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 1000000000,\n        \"step\": \"any\"\n      },\n      {\n        \"key\": \"selfConsumption\",\n        \"label\": \"Generation used on site (%)\",\n        \"value\": 50,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100,\n        \"step\": \"any\"\n      },\n      {\n        \"key\": \"importTariff\",\n        \"label\": \"Avoided import price per kWh\",\n        \"value\": \"\",\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100000,\n        \"step\": \"any\",\n        \"help\": \"Required. Use the marginal energy price avoided, not a standing charge. Enter 0 explicitly if excluded.\"\n      },\n      {\n        \"key\": \"exportTariff\",\n        \"label\": \"Export payment per kWh\",\n        \"value\": \"\",\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100000,\n        \"step\": \"any\",\n        \"help\": \"Required. Enter your export payment, or 0 explicitly if exports have no value.\"\n      },\n      {\n        \"key\": \"degradation\",\n        \"label\": \"Annual generation degradation (%)\",\n        \"value\": 0,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 99,\n        \"step\": \"any\"\n      },\n      {\n        \"key\": \"escalation\",\n        \"label\": \"Annual import and export price change (%)\",\n        \"value\": 0,\n        \"type\": \"number\",\n        \"min\": -99,\n        \"max\": 100,\n        \"step\": \"any\"\n      },\n      {\n        \"key\": \"years\",\n        \"label\": \"Scenario horizon (years)\",\n        \"value\": 25,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100,\n        \"step\": 1\n      }\n    ],\n    \"registrationFamily\": \"home-energy-planning\",\n    \"input\": false,\n    \"live\": false,\n    \"presentation\": \"metrics\",\n    \"note\": \"Calculated on your device for 1 to 100 years. Enter your own import/export prices. Cash flows are undiscounted scenarios, with no tax, subsidy, finance or return guarantee.\",\n    \"experience\": {\n      \"automatic\": false,\n      \"single\": true,\n      \"inputMaxLength\": 1000000,\n      \"inputMode\": \"text\",\n      \"label\": \"Solar value settings\",\n      \"placeholder\": \"Use the fields below\",\n      \"help\": \"Enter installation cost, generation, prices and scenario assumptions in the settings. No text input is needed. Up to 1,000,000 characters. Review the settings before running.\",\n      \"action\": null\n    },\n    \"mode\": \"explicit\",\n    \"interactive\": false\n  },\n  \"execution\": \"Browser interface\",\n  \"api\": null,\n  \"browser_agent\": {\n    \"supported\": true,\n    \"name\": \"run_current_tool\",\n    \"discovery\": \"WebMCP on the human page in a supporting browser\",\n    \"verification\": \"See audit/API-AUDIT.md; availability is not verification\"\n  }\n}\n```\n\n## Page guide\n\nExplore undiscounted solar electricity value and payback from your generation, self-consumption, import/export prices, degradation and tariff-change assumptions.\n\n### How to use Solar payback calculator\n\n1. Enter installed cost and estimated first-year generation.\n2. Enter the self-consumption share and your import and export prices; use an explicit 0 for a price you exclude.\n3. Choose annual degradation, a common import/export price-change assumption and the horizon.\n4. Review year-zero outlay, annual value, cumulative cash flow and nullable payback, then export JSON and CSV.\n\nHow can we improve this tool?\n\nReport a problem or share an idea.\n\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\n\n## Useful next steps\n\n- [Appliance electricity cost calculator](https://happytails.ai/en/calculators/appliance-electricity-cost-calculator/) ([Markdown](https://happytails.ai/en/calculators/appliance-electricity-cost-calculator.md))\n\n- [Hot water energy calculator](https://happytails.ai/en/calculators/hot-water-energy-calculator/) ([Markdown](https://happytails.ai/en/calculators/hot-water-energy-calculator.md))\n\n- [Insulation calculator](https://happytails.ai/en/calculators/insulation-calculator/) ([Markdown](https://happytails.ai/en/calculators/insulation-calculator.md))\n\n## Value of generated electricity\n\nSelf-consumed generation avoids your marginal import energy price. The remainder earns the export payment you enter. Standing charges are not automatically avoided. Prices use one currency, with no tariff, subsidy or tax database.\n\n### A scenario, not a financial promise\n\nDegradation and price changes compound from year two. The self-consumption share remains fixed, and both import and export prices use the same escalation rate. Costs for finance, maintenance, replacements and tax are excluded; cash flows are not discounted.\n\n### Two payback measures\n\nSimple payback divides installation cost by positive first-year electricity value. Cumulative payback finds the first cost crossing in the horizon and interpolates evenly within that year. No crossing is reported as not defined. Zero installation cost has payback zero. The year-zero row records the installation outflow; display rounding occurs after calculations.\n"
}