# BRAINIAC Agent Tool Schema Validator

> BRAINIAC Agent Tool Schema Validator 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).

Validates AI agent tool schemas and their examples against JSON Schema constraints, returning a score and detailed issue list

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-example-validate?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-agent-tool-schema-validator-cbffebbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NEa2R4TB-OMS2yESGiLmw

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-agent-tool-schema-validator-cbffebbd -d '<json body>'
```

Example prompt: Can you validate this agent tool schema for me — I have a tool called 'lookup_product' with an inputSchema requiring name and sku (minLength 2), and two examples: one with sku='A' and an extra 'note' field that's not in the schema? I want to know the score and what's wrong.

## When to prefer this

Use this endpoint when you need to programmatically verify that AI agent tool definitions — including their examples — conform to their declared JSON Schema or OpenAPI schemas. It is purpose-built for agent tooling validation (not general-purpose JSON linting) and returns structured, machine-readable issues with locations and fix suggestions. Prefer this over manual review or generic JSON validators when you need a numeric quality score, severity-tagged issues, and fix recommendations across multiple tools in one call, especially when working with draft-07, 2020-12, OpenAPI 3.0, or 3.1 schemas.

## Known failure modes

- Malformed JSON input returns an error without a score
- $ref pointers to external URLs are not resolved and are reported as failures
- Unsupported JSON Schema dialects may only partially validate
- Empty tools array results in no examples checked and no score returned
- Schema with no examples produces analysis but omits score field
- Input exceeding maxItems (80 tools or 80 schemas) may be rejected or truncated

## 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

A JSON object containing: a numeric score (0–100, percentage of examples passing validation), a boolean success flag, an analysis string summarizing how many examples were checked and how many passed, an issues array with each issue's type, location (e.g. tools[0].examples[0].sku), severity (medium/high), evidence, description, and suggested fix, plus warnings, limitations, and recommendations arrays.

## 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": 50,
  "issues": [
   {
    "type": "additional_property",
    "evidence": "note",
    "location": "tools[0].examples[0]",
    "severity": "medium",
    "description": "The example includes a field the schema rejects.",
    "suggested_fix": "Remove note or declare it in properties."
   },
   {
    "type": "min_length",
    "evidence": "1 < 2",
    "location": "tools[0].examples[0].sku",
    "severity": "medium",
    "description": "The example is shorter than minLength.",
    "suggested_fix": "Use at least 2 characters."
   },
   "…"
  ],
  "success": true,
  "analysis": "Checked 2 examples. 1 matched the declared schema.",
  "warnings": [],
  "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-agent-tool-schema-validator-cbffebbd/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)
