# BRAINIAC PLC Alarm Cluster API

> BRAINIAC PLC Alarm Cluster API 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).

Clusters and analyzes PLC alarm events from industrial control systems to identify patterns, severity, and affected equipment areas

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/robotics-intelligence/plc-alarm-cluster?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-plc-alarm-cluster-api-6958d614
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AOUYLMZnHnKtBbTt54PzY

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-plc-alarm-cluster-api-6958d614 -d '<json body>'
```

Example prompt: I have a CSV export of PLC alarm logs from our Cell area — can you cluster these alarms, identify which ones are high severity, and tell me which controllers are involved? The data covers events as of 2026-11-01.

## When to prefer this

Use this endpoint when you have raw PLC alarm log exports (CSV, JSON, or plain text) and need to automatically cluster, deduplicate, and prioritize alarms without connecting to live industrial equipment. Ideal for post-incident analysis, maintenance preparation, or alarm rationalization workflows where data is already exported from a SCADA or HMI system. Prefer this over manual analysis or general LLM summarization when you need structured cluster output with severity, controller attribution, and temporal metadata.

## Known failure modes

- Malformed or empty CSV/JSON input returns an error or empty cluster list
- Binary file formats like .bag/.mcap cannot be fully decoded — only labeled CSV/JSON exports are supported
- Missing required alarm fields (timestamps, codes) result in incomplete clusters
- Input exceeding 200,000 character limits is rejected
- Alarm values or missing data are never invented — gaps in input produce gaps in output

## 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 alarm clusters, each with area, alarm code, message, severity, first and last occurrence timestamps, event count, and associated controllers. Also includes overall cluster count, status, findings, limitations, and flags confirming no live equipment connection or machine commands were issued.

## 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": [
   {
    "area": "Cell",
    "code": "E101",
    "lastAt": "2026-11-01T11:05:00.000Z",
    "firstAt": "2026-11-01T11:00:00.000Z",
    "message": "Door open",
    "severity": "high",
    "eventCount": 2,
    "controllers": [
     "PLC1"
    ],
    "liveEquipmentConnected": false
   }
  ],
  "status": "clustered",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "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."
  ],
  "clusterCount": 1,
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "machineCommandsIssued": false,
  "liveEquipmentConnected": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-plc-alarm-cluster-api-6958d614/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)
