# BRAINIAC Malware Artifact Cluster Detector

> BRAINIAC Malware Artifact Cluster Detector 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).

Statically clusters submitted file artifacts by hash to detect identical or related malicious files without executing them or contacting external scanners

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/file-security/malware-artifact-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-malware-artifact-cluster-detector-38ad5de7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VUyXaQvCu_ceyWlYUHKPg

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-malware-artifact-cluster-detector-38ad5de7 -d '<json body>'
```

Example prompt: Can you cluster these suspicious binary files by their hashes and tell me if any of them are identical — I want to know if they're related malware artifacts? I have files a.bin (MD5: aaaaaaaaaaaaaaaa, 2048 bytes) and b.bin (MD5: aaaaaaaaaaaaaaaa, 2048 bytes).

## When to prefer this

Choose this endpoint when you need fast, static, local hash-based clustering of file artifacts without any network calls, external scanner dependencies, or API keys — ideal for air-gapped or privacy-sensitive workflows. It is especially useful when you have multiple files and want to detect identical copies or related malware artifacts purely through deterministic hash analysis. Prefer it over full sandbox/dynamic analysis when you only need a quick clustering signal and want zero file execution risk.

## Known failure modes

- Exceeds maxItems (40 artifacts) causing request rejection
- Base64-encoded file content exceeds 12MB per file limit
- Archive decompression limits hit, truncating nested inspection
- Hash not matching any known pattern returns no cluster signal but does not confirm safety
- Missing filename field causes artifact to be rejected (minLength:1 required)
- Malformed or non-hex hash strings may be ignored silently

## 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 an items array of artifact clusters, each containing a cluster ID, title, source, detection status, confidence level, reasons for clustering (e.g. identical_hash), evidence with per-artifact facts, related artifact IDs, observed facts, and an inferred threat hypothesis. Also includes a top-level status, checkedAt timestamp, itemCount, and a limitations array noting that no external scanners or paid threat-intel feeds are used, files are never executed, and absence of matches is not a malware-free verdict.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string",
     "maxLength": 80
    },
    "md5": {
     "type": "string",
     "maxLength": 64
    },
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "sha1": {
     "type": "string",
     "maxLength": 80
    },
    "sha256": {
     "type": "string",
     "maxLength": 128
    },
    "source": {
     "type": "string",
     "maxLength": 200
    },
    "filename": {
     "type": "string",
     "maxLength": 260,
     "minLength": 1
    },
    "mediaType": {
     "type": "string",
     "maxLength": 120
    },
    "sizeBytes": {
     "type": "number",
     "maximum": 100000000,
     "minimum": 0
    },
    "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",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "md5": {
      "type": "string",
      "maxLength": 64
     },
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "sha1": {
      "type": "string",
      "maxLength": 80
     },
     "sha256": {
      "type": "string",
      "maxLength": 128
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "filename": {
      "type": "string",
      "maxLength": 260,
      "minLength": 1
     },
     "mediaType": {
      "type": "string",
      "maxLength": 120
     },
     "sizeBytes": {
      "type": "number",
      "maximum": 100000000,
      "minimum": 0
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "reports": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "text"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "text": {
      "type": "string",
      "maxLength": 200000
     },
     "title": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     }
    },
    "additionalP
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "cluster-hash-aaaaaaaaaaaaaaaa",
    "title": "Identical-hash artifact cluster",
    "source": "Caller-supplied artifacts; deterministic hash clustering",
    "status": "signal",
    "reasons": [
     "identical_hash"
    ],
    "detector": "malware-artifact-cluster",
    "evidence": [
     {
      "fact": "filename=a.bin; magic=empty; size=2048",
      "subject": "F1",
      "confidence": "high"
     },
     {
      "fact": "filename=b.bin; magic=empty; size=2048",
      "subject": "F2",
      "confidence": "high"
     }
    ],
    "confidence": "high",
    "relatedIds": [
     "F1",
     "F2"
    ],
    "observedFacts": [
     "2 artifacts share hash aaaaaaaaaaaaaaaa…"
    ],
    "inferredThreat": "Identical hashes indicate the same bytes; malice is not confirmed by clustering alone.",
    "confirmedMalware": false
   }
  ],
  "status": "detected",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "itemCount": 1,
  "limitations": [
   "Files and analysis reports are copied only from caller-supplied fields. Uploaded bytes are never executed and are never sent to external malware scanners.",
   "Analysis is static/local only with strict decoded-size, archive-depth, entry-count, and decompression limits.",
   "Observed facts are separated from inferred threat hypotheses. Absence of matched patterns is not a malware-free verdict.",
   "Nested archive inspection lists metadata and may inflate only small members within decompression caps.",
   "No paid threat-intel feed is used and no API key is required."
  ],
  "fileExecuted": false,
  "apiKeyRequired": false,
  "networkAccessed": false,
  "paidProviderUsed": false,
  "externalScannerUsed": false,
  "malwareFreeNotClaimed": true,
  "confirmedMalwareClaimed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-malware-artifact-cluster-detector-38ad5de7/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)
