# BRAINIAC Tool Schema Required Field Audit

> BRAINIAC Tool Schema Required Field Audit is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-11).

Audits the `required` arrays in AI agent tool schemas to detect missing property definitions, duplicates, and other structural issues that cause agent misbehavior.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-required-field-audit?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-tool-schema-required-field-audit-b24e6bcb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_80RrZdAGR8786n0lE-u8H

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-tool-schema-required-field-audit-b24e6bcb -d '<json body>'
```

Example prompt: Can you audit these two tool definitions for required-field problems — I want to know if any required fields are missing from properties, if there are duplicates, and get an overall quality score back so I can fix issues before shipping.

## When to prefer this

Use this endpoint when you need a fast, deterministic, structural audit of AI agent tool schemas focused specifically on `required` array correctness — detecting missing property definitions, duplicates, and problematic defaults. Prefer this over manual review or general JSON Schema validators when you want an agent-interpretable score, actionable issue list with severity and suggested fixes, and coverage across both JSON Schema (draft-07, 2020-12) and OpenAPI (3.0, 3.1) dialects. Best suited for CI pipelines, pre-deployment checks, or debugging agent tool call failures.

## Known failure modes

- Malformed JSON in input schema causes parsing error
- Input exceeds 80 tools limit and is rejected
- Tool name missing causes validation failure on required 'name' field
- Schema dialect not supported leads to partial or skipped checks
- $ref to external URLs not fetched — only same-document $defs resolved
- Payment not completed via x402 results in 402 response and no audit

## 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: a numeric score (0–100) reflecting schema quality, a list of issues each with type, severity (high/low), location, evidence, description, and suggested fix, a list of warnings for non-score-impacting problems (e.g. defaults on required fields), an analysis summary string, limitations of the audit engine, and an empty or populated recommendations array.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tools": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
     },
     "examples": {
      "type": "array",
      "items": {},
      "maxItems": 10
     },
     "parameters": {
      "type": "object",
      "propertyNames": {
       "type": "string",
       "maxLength": 80
      },
      "additionalProperties": {}
     },
     "description": {
      "type": "string",
      "maxLength": 8000
     },
     "inputSchema": {
      "type": "object",
      "propertyNames": {
       "type": "string",
       "maxLength": 80
      },
      "additionalProperties": {}
     },
     "outputSchema": {
      "type": "object",
      "propertyNames": {
       "type": "string",
       "maxLength": 80
      },
      "additionalProperties": {}
     }
    },
    "additionalProperties": false
   },
   "maxItems": 80
  },
  "openapi": {
   "type": "object",
   "propertyNames": {
    "type": "string",
    "maxLength": 80
   },
   "additionalProperties": {}
  },
  "schemas": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "schema"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
     },
     "schema": {
      "type": "object",
      "propertyNames": {
       "type": "string",
       "maxLength": 80
      },
      "additionalProperties": {}
     }
    },
    "additionalProperties": false
   },
   "maxItems": 80
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 81,
  "issues": [
   {
    "type": "duplicate_required",
    "evidence": "sku",
    "location": "tools[0].parameters.required",
    "severity": "low",
    "description": "The required array lists the same field twice.",
    "suggested_fix": "List each required field once."
   },
   {
    "type": "required_missing_property",
    "evidence": "quantity",
    "location": "tools[0].parameters.required",
    "severity": "high",
    "description": "The agent is required to send a field that is not defined.",
    "suggested_fix": "Define properties.quantity or stop requiring it."
   }
  ],
  "success": true,
  "analysis": "Audited required arrays on 1 tools.",
  "warnings": [
   {
    "type": "required_has_default",
    "location": "tools[0].parameters.properties.sku",
    "description": "sku is required and also has a default. Agents may disagree about whether to send it."
   },
   {
    "type": "required_has_default",
    "location": "tools[0].parameters.properties.sku",
    "description": "sku is required and also has a default. Agents may disagree about whether to send it."
   }
  ],
  "limitations": [
   "Checks use the supplied JSON only. No schema URL is fetched and no model reads the text.",
   "Supported dialects for keyword checks are JSON Schema draft-07, JSON Schema 2020-12, OpenAPI 3.0, and OpenAPI 3.1. Othe…",
   "…"
  ],
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-tool-schema-required-field-audit-b24e6bcb/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)
