# BRAINIAC Robotics Downtime Root Cause Analyzer

> BRAINIAC Robotics Downtime Root Cause Analyzer 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).

Analyzes robotics and industrial automation telemetry data to identify and cluster the root causes of equipment downtime events

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/robotics-intelligence/downtime-root-cause?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-robotics-downtime-root-cause-analyzer-1bd0f3c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wyVVFm3GHKIC0xj6ei5-Z

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-robotics-downtime-root-cause-analyzer-1bd0f3c0 -d '<json body>'
```

Example prompt: Can you analyze this CSV of robot cycle and sensor data for robot R1 in workcell WC3 and tell me what caused the 900 seconds of downtime we saw yesterday — cluster the root causes and give me codes and categories for each?

## When to prefer this

Use this endpoint when you have robotics or industrial automation telemetry data (cycle logs, sensor samples, PLC alarms, maintenance records) and need to systematically identify and cluster the root causes of downtime events without establishing a live connection to equipment. Ideal for post-shift analysis, incident investigation, or batch review of exported robot data. Prefer this over generic LLM analysis when you need structured fault codes, categories, and duration metrics tied to specific robot and workcell IDs.

## Known failure modes

- Insufficient or malformed telemetry data returns empty or low-confidence findings
- Binary .bag/.mcap files are not decoded — must supply topic CSV/JSON exports instead
- Missing duration fields result in incomplete downtime estimates
- Unrecognized fault codes may not be clustered correctly
- Exceeding maxItems limits on samples (5000) or cycles (2000) may truncate analysis

## 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

A JSON object containing an array of clustered downtime root cause items (each with a fault code, human-readable message, category like 'safety' or 'motion', affected robot IDs, event count, and total downtime duration in seconds), plus a status field, overall cause count, findings list, timestamp, and a list of limitations explaining what data sources were and were not used in the analysis.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "cycles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "endedAt": {
      "type": "string",
      "maxLength": 40
     },
     "program": {
      "type": "string",
      "maxLength": 160
     },
     "robotId": {
      "type": "string",
      "maxLength": 80
     },
     "startedAt": {
      "type": "string",
      "maxLength": 40
     },
     "workcellId": {
      "type": "string",
      "maxLength": 80
     },
     "durationSec": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 2000
  },
  "samples": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "unit": {
      "type": "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "code": "ESTOP",
    "message": "Operator e-stop",
    "category": "safety",
    "robotIds": [
     "R1"
    ],
    "eventCount": 1,
    "totalDurationSec": 900,
    "liveEquipmentConnected": false,
    "totalDurationSecSupplied": true
   },
   {
    "code": "SERVO01",
    "message": "Servo overtemperature",
    "category": "motion",
    "robotIds": [
     "R1"
    ],
    "eventCount": 1,
    "totalDurationSec": 300,
    "liveEquipmentConnected": false,
    "totalDurationSecSupplied": true
   }
  ],
  "status": "clustered",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "causeCount": 2,
  "limitations": [
   "ROS bag topic samples, schemas, cycles, downtime, OPC UA tags, PLC alarms, maintenance records, and protocol declarations are copied only from labeled fields or text/CSV/JSON exports supplied by the caller.",
   "No live industrial equipment connection is opened and no machine commands are issued.",
   "Binary .bag/.mcap files are not fully decoded here. Supply topic CSV/JSON exports or labeled sample rows. Missing values are not invented.",
   "Anomaly, cycle-time, downtime, and maintenance estimates use only supplied measurements and intervals.",
   "Protocol compatibility compares caller-supplied required versus available protocol names, versions, and features only. Protocol specifications are not invented."
  ],
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "machineCommandsIssued": false,
  "liveEquipmentConnected": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-robotics-downtime-root-cause-analyzer-1bd0f3c0/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)
