# BRAINIAC Building Energy Baseline Calculator

> BRAINIAC Building Energy Baseline Calculator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Calculates energy consumption baselines from meter readings, bills, and tariffs to identify savings and performance benchmarks for buildings.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/building-energy/baseline-calculate?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-building-energy-baseline-calculator-86ff7cc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4IErpifdMcvnjDgWtm3db

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-building-energy-baseline-calculator-86ff7cc3 -d '<json body>'
```

Example prompt: Calculate the energy baseline for building B-1 using these meter readings for meter M-1 — electricity in kWh — with readings from Jan through Dec 2024, and tell me the mean daily usage and whether anything looks unusual.

## When to prefer this

Choose this endpoint when you need a rigorous, auditable energy baseline calculation from structured meter data, bills, or tariff records — especially for compliance, ESG reporting, or M&V (measurement and verification) workflows. It explicitly guarantees no invented tariffs, no fabricated performance claims, and no equipment control, making it suitable for formal energy audits. Prefer it over general-purpose LLM analysis when you need deterministic, reproducible baseline statistics with documented methodology and limitations.

## Known failure modes

- Insufficient readings for a meter — not enough data points to compute a statistically meaningful baseline
- Incompatible units across buildings — comparison skipped when measurement periods or units don't align
- Missing tariff data — costs cannot be calculated without supplied tariff rates; tariffs are never invented
- Malformed CSV or JSON input — parse errors returned if data format is invalid
- Exceeding maxItems limits — bills array capped at 200 items, meters at 200, tariffs at 100
- File too large — base64 file content capped at ~12MB

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with an array of baseline items per meter, each including the baseline mean, standard deviation, baseline method used (e.g. mean_daily_interval), comparison unit, sample count, utility type, and building ID. Also includes overall status ('calculated'), any analytical findings, a checkedAt timestamp, and a detailed limitations list clarifying that tariffs are not invented, equipment is not controlled, and performance is not fabricated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "bills": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "cost": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "unit": {
      "type": "string",
      "maxLength": 40
     },
     "utility": {
      "type": "string",
      "maxLength": 80
     },
     "quantity": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "periodEnd": {
      "type": "string",
      "maxLength": 40
     },
     "buildingId": {
      "type": "string",
      "maxLength": 80
     },
     "periodStart": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "meters": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "unit": {
      "type": "string",
      "maxLength": 40
     },
     "utility": {
      "type": "string",
      "maxLength": 80
     },
     "buildingId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "tariffs": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "asOf": {
      "type": "string",
      "maxLength": 40
     },
     "rate": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "unit": {
      "type": "string",
      "maxLength": 40
     },
     "utility": {
      "type": "string",
      "maxLength": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "unit": "kWh",
    "meterId": "M-1",
    "utility": "electric",
    "buildingId": "B-1",
    "sampleCount": 3,
    "baselineMean": 10,
    "baselineStdev": 0,
    "baselineMethod": "mean_daily_interval",
    "comparisonUnit": "kWh",
    "tariffInvented": false,
    "savingsGuaranteed": false,
    "performanceInvented": false,
    "baselineMeanSupplied": true,
    "baselineStdevSupplied": true
   }
  ],
  "status": "calculated",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "limitations": [
   "Meter readings, bills, tariffs, equipment records, and occupancy rows are copied only from labeled fields supplied by the caller.",
   "Consumption and cost use supplied units and tariffs only. Missing tariffs are not invented.",
   "Unusual usage is compared against a baseline calculated from supplied readings for the same meter or utility.",
   "Buildings are compared only when measurement periods and units are compatible.",
   "Equipment performance and savings are never invented. HVAC and connected equipment are never controlled."
  ],
  "tariffInvented": false,
  "savingsGuaranteed": false,
  "equipmentControlled": false,
  "performanceInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-building-energy-baseline-calculator-86ff7cc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
