{"uid":"cap_AOUYLMZnHnKtBbTt54PzY","slug":"brainiac-plc-alarm-cluster-api-6958d614","name":"BRAINIAC PLC Alarm Cluster API","description":"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.","url":"https://www.brainiac.software/api/v1/robotics-intelligence/plc-alarm-cluster?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":"string","maxLength":40},"field":{"type":"string","maxLength":120},"topic":{"type":"string","maxLength":200},"value":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000},"schemas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"side":{"enum":["left","right","a","b"],"type":"string"},"topic":{"type":"string","maxLength":200},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":80},"optional":{"type":"boolean"}},"additionalProperties":false},"maxItems":200},"source":{"type":"string","maxLength":200},"messageType":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":200},"downtime":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"message":{"type":"string","maxLength":400},"robotId":{"type":"string","maxLength":80},"category":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"workcellId":{"type":"string","maxLength":80},"durationSec":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"opcuaTags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"path":{"type":"string","maxLength":300},"unit":{"type":"string","maxLength":40},"nodeId":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"dataType":{"type":"string","maxLength":80},"browseName":{"type":"string","maxLength":160},"displayName":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":2000},"plcAlarms":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":120},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":400},"severity":{"type":"string","maxLength":40},"controllerId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"protocols":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"role":{"enum":["required","available","controller","device"],"type":"string"},"source":{"type":"string","maxLength":200},"version":{"type":"string","maxLength":80},"features":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":40}},"additionalProperties":false},"maxItems":100},"maintenance":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80},"component":{"type":"string","maxLength":160},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"runtimeHours":{"type":"number","maximum":1000000000,"minimum":0},"intervalHours":{"type":"number","maximum":1000000000,"minimum":0},"lastServiceAt":{"type":"string","maxLength":40},"intervalCycles":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1YHCUn3PSWyHcdNpTxtV2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Clusters and analyzes PLC alarm events from industrial control systems to identify patterns, severity, and affected equipment areas","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Factory floor alarm flood analysis","prompt":"We had a major alarm event on the factory floor last Tuesday — here's the CSV export of all PLC alarms from that shift. Can you cluster them, tell me which are high severity, and which controllers and areas were most affected?"},{"title":"Recurring alarm pattern detection","prompt":"I keep seeing the same alarms fire repeatedly on PLC1 in our Assembly Cell. Here's a JSON export of the last week's alarm log — can you cluster these and show me which ones are recurring most often and when they first and last fired?"},{"title":"Multi-controller alarm summary for maintenance review","prompt":"Before our maintenance meeting tomorrow, can you take this alarm CSV from all three of our PLCs and cluster the alarms by area and severity so we can prioritize which issues to address first?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:58.245Z","isFirstParty":false,"canonicalSlug":"brainiac-plc-alarm-cluster-api-6958d614"}