# BRAINIAC Security Event Correlator

> BRAINIAC Security Event Correlator 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).

Correlates a set of security events by time proximity and shared actor/host/IP to identify incident clusters and inferred threats

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/security-signals/event-correlate?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-security-event-correlator-120453d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K5qqJ4d9-oEoCf_QI1Fxb

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-security-event-correlator-120453d9 -d '<json body>'
```

Example prompt: I have a list of security events from the past hour — auth failures on vpn-1, then a successful login, then a remote logon on app-2 — can you correlate them to see if they form a single incident cluster and tell me the inferred threat and confidence level?

## When to prefer this

Use this endpoint when you have a set of discrete security events (from logs, SIEM exports, or inline JSON/CSV) and want to quickly identify whether they form related incident clusters without setting up a full SIEM pipeline. It is ideal for pay-per-call, no-account workflows where you need lightweight event correlation with explicit confidence scores and inferred threat narratives. Prefer this over a full SIEM when you need a fast, stateless analysis of a bounded event window and do not require enrichment from live threat-intel feeds or endpoint agents.

## Known failure modes

- Insufficient events provided — fewer than 2 events makes correlation trivial or impossible
- Events missing key fields (userId, host, sourceIp) reduce correlation quality and confidence
- Very large event arrays near the schema limits may be truncated
- Time window too broad or too narrow may result in no meaningful clusters
- Ambiguous or missing timestamps prevent time-proximity grouping
- No external threat intel used — cannot confirm known attacker IOCs
- Returns confirmedAttack=false unless multi-signal evidence is present — may feel conservative

## 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 JSON object with correlated event groups (each with a unique ID, first/last timestamp, shared actor/host reasons, evidence items with per-event facts and inferences, confidence level, observed facts, inferred threat hypothesis, and whether the attack is confirmed), plus top-level findings, group count, checked timestamp, and a limitations list clarifying the scope of the local-rule 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
  },
  "events": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "host": {
      "type": "string",
      "maxLength": 253
     },
     "count": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "action": {
      "type": "string",
      "maxLength": 120
     },
     "labels": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 80
      },
      "maxItems": 40
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "userId": {
      "type": "string",
      "maxLength": 120
     },
     "message": {
      "type": "string",
      "maxLength": 4000
     },
     "mfaUsed": {
      "type": "boolean"
     },
     "outcome": {
      "enum": [
       "success",
       "failure",
       "unknown"
      ],
      "type": "string"
     },
     "process": {
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "event-correlate-E1",
    "title": "Related security event group",
    "lastAt": "2026-11-04T20:10:00.000Z",
    "source": "Caller-supplied events; local rules only",
    "status": "signal",
    "firstAt": "2026-11-04T20:00:00.000Z",
    "reasons": [
     "time_window",
     "shared_actor",
     "shared_host"
    ],
    "detector": "event-correlate",
    "evidence": [
     {
      "at": "2026-11-04T20:00:00.000Z",
      "fact": "auth_failure on vpn-1 outcome=failure",
      "eventId": "E1",
      "inference": "Grouped by caller-supplied fields and time proximity only.",
      "confidence": "medium"
     },
     {
      "at": "2026-11-04T20:05:00.000Z",
      "fact": "auth_success on vpn-1 outcome=success",
      "eventId": "E2",
      "inference": "Grouped by caller-supplied fields and time proximity only.",
      "confidence": "medium"
     },
     {
      "at": "2026-11-04T20:10:00.000Z",
      "fact": "remote_logon on app-2 outcome=success",
      "eventId": "E3",
      "inference": "Grouped by caller-supplied fields and time proximity only.",
      "confidence": "medium"
     }
    ],
    "confidence": "medium",
    "observedFacts": [
     "3 events occurred within 60 minutes.",
     "Shared actor keys: u1.",
     "Shared host keys: vpn_1, app_2."
    ],
    "inferredThreat": "Events may belong to one incident cluster based on time proximity and shared actor/host/IP links.",
    "confirmedAttack": false,
    "relatedEventIds": [
     "E1",
     "E2",
     "E3"
    ]
   }
  ],
  "status": "correlated",
  "findings": [
   {
    "code": "event_group",
    "kind": "observation",
    "detail": "Correlated 3 events (confidence=medium, confirmedAttack=false).",
    "subject": "event-correlate-E1"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "groupCount": 1,
  "limitations": [
   "Security events and logs are copied only from labeled fields supplied by the caller. The caller's network and security infrastructure are not accessed.",
   "Detections are local rule and time-window analyses over supplied records. Missing values are not invented.",
   "Observed facts are separated from inferred threat hypotheses. Events are not labeled confirmed attacks without sufficient multi-signal evidence.",
   "No paid threat-intel feed or endpoint agent is used and no API key is required.",
   "Severity scores are explainable rule weights over supplied detections/events, not vendor risk scores."
  ],
  "wi
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-security-event-correlator-120453d9/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)
