# BRAINIAC Construction Site Instruction Extract

> BRAINIAC Construction Site Instruction Extract 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).

Extracts and classifies site instructions from construction project data (daily reports, RFIs, schedules, delays, scope items) to identify changes, liability events, and entitlement triggers.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/construction-site-operations/instruction-extract?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-construction-site-instruction-extract-c01b65ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3gT1MtPOxgiANcT4TdGKc

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-construction-site-instruction-extract-c01b65ed -d '<json body>'
```

Example prompt: Go through these construction daily reports and RFIs and pull out all the site instructions — flag any that represent changes, note who issued them, and tell me which activities they're linked to, but don't make any determination on liability or entitlement.

## When to prefer this

Use this endpoint when you need structured extraction of site instructions from raw construction project data (daily reports, RFIs, delays, scope items) and want explicit, conservative output that never invents dates, never determines entitlement or liability, and always flags its own limitations. Prefer this over general-purpose LLM analysis when you need auditable, claims-ready instruction records with clear change/non-change classification and activity linkage, without hallucinated legal conclusions.

## Known failure modes

- Input data too large (exceeds maxLength limits for text, CSV, or JSON fields)
- Missing required file fields (mediaType or fileBase64 absent when file object is used)
- Unsupported media type for file upload (only text/plain, text/csv, application/json accepted)
- Ambiguous or malformed date strings in asOf, RFI due/asked/answered fields
- No extractable instructions found — returns empty items array with status extracted
- Payment failure via x402 — 402 response if USDC payment on Base is not completed
- Overly sparse input data resulting in findings with limitations noted rather than items

## 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 structured list of extracted site instruction items, each with an ID, date, text, change flag, issuer, location, event kind, referenced activity IDs, and flags for whether change, liability, or entitlement was determined. Also includes a total change count, any analytical findings, an explicit list of limitations (e.g. no invented dates, no entitlement rulings), and flags confirming that delays were not invented and liability/entitlement were not determined.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "rfis": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "due": {
      "type": "string",
      "maxLength": 40
     },
     "asked": {
      "type": "string",
      "maxLength": 40
     },
     "asker": {
      "type": "string",
      "maxLength": 120
     },
     "status": {
      "type": "string",
      "maxLength": 80
     },
     "subject": {
      "type": "string",
      "maxLength": 300
     },
     "answered": {
      "type": "string",
      "maxLength": 40
     },
     "responder": {
      "type": "string",
      "maxLength": 120
     },
     "activityId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "scope": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "text": {
      "type": "string",
      "maxLength": 1000
     },
     "activityId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "delays": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "days": {
      "type": "number",
      "maximum": 3650,
      "minimum": 0
     },
     "reason": {
      "type": "string",
      "maxLength": 500
     },
     "recorded": {
      "type": "boolean"
     },
     "activityId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 2
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "SI-1",
    "date": "2026-11-04",
    "text": "Change window opening size on Level 2 Frame",
    "change": true,
    "issuer": "Architect",
    "location": "Level 2",
    "eventKind": "recorded",
    "activityId": "A-2",
    "changeSupplied": true,
    "liabilityDetermined": false,
    "referencedActivities": [
     "A-2"
    ],
    "entitlementDetermined": false
   },
   {
    "id": "SI-2",
    "date": "2026-11-05",
    "text": "Confirm access route remains clear",
    "change": false,
    "issuer": "PM",
    "location": "",
    "eventKind": "recorded",
    "activityId": "",
    "changeSupplied": false,
    "liabilityDetermined": false,
    "referencedActivities": [],
    "entitlementDetermined": false
   }
  ],
  "status": "extracted",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "changeCount": 1,
  "limitations": [
   "Daily reports, schedules, RFIs, instructions, and deliveries are copied only from labeled fields supplied by the caller.",
   "Schedule deviations use only supplied baseline and actual dates. Missing dates are not invented.",
   "A recorded delay event is taken from supplied delay rows or explicit daily-report delay wording. Inferred impact is labeled separately.",
   "Contractual entitlement and liability are never determined.",
   "Unresolved RFIs and missing deliveries are judged only against supplied due/expected dates and statuses."
  ],
  "delayInvented": false,
  "liabilityDetermined": false,
  "entitlementDetermined": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-construction-site-instruction-extract-c01b65ed/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)
