# BRAINIAC Building Energy — Equipment Maintenance Priority

> BRAINIAC Building Energy — Equipment Maintenance Priority 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).

Ranks building equipment by maintenance urgency using fault counts, runtime hours, service history, and performance data, returning a prioritized list with scores and reasons.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/building-energy/equipment-maintenance-priority?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-equipment-maintenance-priority-d0252f19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qzR88f6NNstsiLinuU3Fv

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-equipment-maintenance-priority-d0252f19 -d '<json body>'
```

Example prompt: I have a list of HVAC and pump equipment for Building B-1 — AHU-1 has 4 faults, 9500 runtime hours, was last serviced on 2025-01-01 with the next service due 2026-10-01, and Pump-1 has 0 faults, 1000 runtime hours, last serviced 2026-09-01 due 2027-01-01. Can you rank them by maintenance priority and tell me which ones are most urgent?

## When to prefer this

Use this endpoint when you have structured equipment records (fault counts, runtime hours, service history) and need an AI-scored, rank-ordered maintenance priority list rather than a simple sort. It is particularly valuable when data arrives in mixed formats (CSV, JSON, text, structured arrays) and you need transparent scoring with explicit reasons and limitations — not invented performance figures. Prefer it over generic analytics when you need an audit-ready output that clearly flags what was supplied vs. assumed.

## Known failure modes

- Missing or malformed equipment records result in items with score 0 and no priority signals
- Tariffs or meter readings not supplied are not invented — cost/consumption analysis is skipped
- Incompatible units or time periods between buildings prevent cross-building comparison
- Exceeding maxItems limits (200 equipment, 200 meters, 200 bills) truncates input
- Invalid date formats in asOf, lastServiceAt, or nextServiceDue fields may cause incorrect overdue calculations
- Empty input returns an empty items array with status 'prioritized' and no findings

## 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 ranked list of equipment items, each with a numeric score (0–100), priority level (high/low), rank, overdue days, fault count, runtime hours, days since last service, and human-readable reasons explaining the score. Also includes aggregate counts, findings (observations or warnings), and a list of limitations describing what data was and was not invented or assumed.

## 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": [
   {
    "id": "EQ-1",
    "name": "AHU-1",
    "rank": 1,
    "type": "hvac",
    "score": 90,
    "reasons": [
     "service overdue by 40 days against supplied due date",
     "4 supplied fault count",
     "measured efficiency below 90% of rated efficiency",
     "runtime hours at or above 8000"
    ],
    "priority": "high",
    "buildingId": "B-1",
    "faultCount": 4,
    "overdueDays": 40,
    "runtimeHours": 9500,
    "lastServiceAt": "2025-01-01",
    "nextServiceDue": "2026-10-01",
    "daysSinceService": 678,
    "savingsGuaranteed": false,
    "faultCountSupplied": true,
    "equipmentControlled": false,
    "overdueDaysSupplied": true,
    "performanceInvented": false,
    "runtimeHoursSupplied": true,
    "daysSinceServiceSupplied": true
   },
   {
    "id": "EQ-2",
    "name": "Pump-1",
    "rank": 2,
    "type": "pump",
    "score": 0,
    "reasons": [],
    "priority": "low",
    "buildingId": "B-1",
    "faultCount": 0,
    "overdueDays": 0,
    "runtimeHours": 1000,
    "lastServiceAt": "2026-09-01",
    "nextServiceDue": "2027-01-01",
    "daysSinceService": 70,
    "savingsGuaranteed": false,
    "faultCountSupplied": true,
    "equipmentControlled": false,
    "overdueDaysSupplied": false,
    "performanceInvented": false,
    "runtimeHoursSupplied": true,
    "daysSinceServiceSupplied": true
   }
  ],
  "status": "prioritized",
  "findings": [
   {
    "code": "no_priority_signal",
    "kind": "observation",
    "detail": "No overdue service, faults, efficiency drop, or high runtime was present in supplied fields.",
    "subject": "EQ-2"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "highCount": 1,
  "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-equipment-maintenance-priority-d0252f19/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)
