# BRAINIAC Building Energy Occupancy Compare

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

Compares energy consumption per occupant across two buildings (or periods) using supplied meter readings, bills, tariffs, and occupancy data, returning a structured compatibility assessment and per-occupant efficiency metrics.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/building-energy/occupancy-compare?utm_source=zero.xyz
- Price: $0.05/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-occupancy-compare-47b08919
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q7CevEdkUWV63E_Pnm1hM

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-occupancy-compare-47b08919 -d '<json body>'
```

Example prompt: Compare the energy efficiency of our two office buildings — Building B-1 had 100 occupants using 200 kWh and Building B-2 had 80 occupants using 120 kWh over the same week from November 1 to November 8, 2026. Tell me which building is more efficient per person.

## When to prefer this

Use this endpoint when you need to compare energy consumption normalized by occupancy across two buildings or time periods, using your own meter readings, utility bills, and tariff data. It is specifically designed for per-occupant energy benchmarking with explicit handling of missing tariffs, unit compatibility checks, and transparent limitation disclosures — preferred over generic analytics when you need auditable, compliance-friendly building energy comparison with no invented data.

## Known failure modes

- Incompatible periods or units between buildings result in compatible:false with no comparison item produced
- Missing tariff data produces a findings entry with code 'tariff' and kind 'missing', and cost is not calculated
- Buildings with no overlapping measurement periods cannot be compared
- Malformed or missing meter/reading arrays may result in empty items array
- Exceeding maxItems limits (200 meters, 200 bills, 100 tariffs) may cause truncation or rejection
- Invalid date formats in periodStart/periodEnd or asOf fields may cause parsing errors

## 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 list of comparison items, each containing the period, unit, left and right building IDs, total quantities, occupant counts, per-occupant consumption figures, compatibility flag, and an explanation reason. Also includes findings (e.g. missing tariff warnings), a checkedAt timestamp, a list of limitations (e.g. no equipment control, no invented savings), and flags for tariffInvented, savingsGuaranteed, equipmentControlled, and performanceInvented — all set to false for transparency.

## 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",
    "reason": "Compared because overlapping/matching periods and compatible energy units were supplied.",
    "periodEnd": "2026-11-08",
    "compatible": true,
    "periodStart": "2026-11-01",
    "leftQuantity": 200,
    "leftOccupants": 100,
    "rightQuantity": 120,
    "leftBuildingId": "B-1",
    "rightOccupants": 80,
    "tariffInvented": false,
    "leftPerOccupant": 2,
    "rightBuildingId": "B-2",
    "rightPerOccupant": 1.5,
    "savingsGuaranteed": false,
    "leftPerOccupantSupplied": true,
    "rightPerOccupantSupplied": true
   }
  ],
  "status": "compared",
  "findings": [
   {
    "code": "tariff",
    "kind": "missing",
    "detail": "No supplied tariff matched this meter utility/unit, so cost was not calculated.",
    "subject": "M-1"
   },
   {
    "code": "tariff",
    "kind": "missing",
    "detail": "No supplied tariff matched this meter utility/unit, so cost was not calculated.",
    "subject": "M-2"
   }
  ],
  "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,
  "compatibleCount": 1,
  "savingsGuaranteed": false,
  "equipmentControlled": false,
  "performanceInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-building-energy-occupancy-compare-47b08919/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)
