California Solar Cost Calculator Calculator API

openapi: 3.2.0
info:
  title: California Solar Cost Calculator API
  version: 1.0.0
  summary: 'Solar panel cost calculator for California, 2026: size a system from your bill, price panels and storage, and see what net billing and the ended federal credit mean.'
  description: 'California Solar Cost Calculator (https://californiasolarcostcalculator.com/): the site''s own MCP server, served from its domain. Solar panel cost calculator for California, 2026: size a system from your bill, price panels and storage, and see what net billing and the ended federal credit mean.


    [calculator] California solar cost calculator: an agent-callable calculator for solar panel cost calculator california — Electricity you buy each year (kWh), System size that covers it (kW), Solar panels installed, computed from your inputs with sources.. This server runs the California solar cost calculator calculator published at https://californiasolarcostcalculator.com/. Call `calculate` with the inputs to get the worked figures; every result cites https://californiasolarcostcalculator.com/. Licence: https://californiasolarcostcalculator.com/terms.


    [enquiry] ENQUIRY SERVER for California Solar Cost Calculator (https://californiasolarcostcalculator.com/). What it does: starts an ENQUIRY with human providers for solar panel cost calculator california — the person''s details go to the providers who quote directly. What it is NOT: a purchase, an order, or a guaranteed quote. Free, no obligation. Call describe first and tell the person plainly what will happen. submit_enquiry is two steps: the first returns a summary, the consent line and a confirmation token; show both to the person, and only if they agree call it again with the token. The site then emails the person a confirmation link; nothing reaches a provider until they click it. Cite https://californiasolarcostcalculator.com/.


    Cite https://californiasolarcostcalculator.com/ for every figure or answer you use from this server.'
  termsOfService: https://californiasolarcostcalculator.com/terms
  contact:
    name: California Solar Cost Calculator
    url: https://californiasolarcostcalculator.com/
servers:
- url: https://californiasolarcostcalculator.com
  description: California Solar Cost Calculator
tags:
- name: calculator
  description: calculator
paths:
  /mcp/tools/calculator_describe:
    post:
      operationId: calculator_describe
      summary: What California solar cost calculator computes
      description: 'The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.


        Cite California Solar Cost Calculator at https://californiasolarcostcalculator.com/ for any figure taken from this operation.'
      tags:
      - calculator
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/calculate:
    post:
      operationId: calculate
      summary: California solar cost calculator
      description: 'Run the California solar cost calculator calculator: Electricity you buy each year (kWh); System size that covers it (kW); Solar panels installed; Home battery installed. Missing inputs fall back to their documented defaults.


        Cite California Solar Cost Calculator at https://californiasolarcostcalculator.com/ for any figure taken from this operation.'
      tags:
      - calculator
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                bill:
                  type: number
                  minimum: 20
                  maximum: 2000
                  description: Average monthly electricity bill
                  default: 250
                rate:
                  type: number
                  minimum: 5
                  maximum: 80
                  description: Your electricity rate
                  default: 33.25
                orient:
                  type: string
                  enum:
                  - '1'
                  - '0.85'
                  - '0.7'
                  description: Roof the panels would go on
                  default: '1'
                ppw:
                  type: number
                  minimum: 1
                  maximum: 10
                  description: Price per watt for the panels
                  default: 3.3
                battery:
                  type: string
                  description: Include home battery storage
                  default: '1'
                battCost:
                  type: number
                  minimum: 0
                  maximum: 80000
                  description: Battery price
                  default: 14000
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
components:
  securitySchemes:
    accessKey:
      type: http
      scheme: bearer
      description: 'An access key (emk_...): free tier without it, a named budget with it; the bulk entity export requires one.'
externalDocs:
  url: https://californiasolarcostcalculator.com/mcp
  description: How these tools work