Documentation

Understand how Celvanto calculates appliance lifecycle costs, or integrate our analysis engine into your own application via the REST API.

Quickstart

Enter an appliance, your state and its yearly energy use to get a lifecycle cost with a confidence range.

Lifecycle Cost Model

Purchase plus discounted energy, water, maintenance and repair costs, less resale value.

Monte Carlo Range

Thousands of simulated ownership paths give a 5th to 95th percentile range around the estimate.

Repair and Failure Model

Weibull failure timing with authored lifetimes, and what that means for the range.

Data Sources

Electricity and gas prices from EIA, price growth from BLS, efficiency classes from ENERGY STAR.

API and MCP

The same calculation over REST and as MCP tools, with an OpenAPI document.

API Endpoints

POST/api/calculateTotal cost of ownership for one appliance, with a confidence object

POST/api/compareCompare two appliances (for example keep against replace)

POST/api/sensitivityWhich inputs move the answer most; break-even between two appliances

POST/api/economic-lifeThe age at which keeping costs more per year than replacing

POST/mcpMCP over HTTP: calculate_appliance_tco and compare_appliances

GET/v1/data/sourcesEvery data source with its fetch time, row count and status (API key)

GET/openapi.jsonThe request schema of the compute routes

Authentication

MCP tool calls and the data routes need an API key in the X-API-Key header. The compute routes also answer without a key, limited to 50 calls a day per address; /api/calculate then returns the headline and its range.

curl -X POST https://celvanto-api.smarttechinvest.com/api/calculate \
  -H "X-API-Key: cvt_live_your_key_here" -H "Content-Type: application/json" \
  -d '{"name":"Fridge","brand":"LG","type":"refrigerator","energySource":"electric","condition":"good","purchasePrice":1500,"currentAge":6,"analysisPeriodYears":10,"annualEnergyConsumption":600,"state":"CA"}'