# BRAINIAC Tool Schema Compatibility Checker

> BRAINIAC Tool Schema Compatibility Checker 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 against a target JSON Schema or OpenAPI dialect, returning a compatibility score and actionable issue list

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-compatibility-check?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-tool-schema-compatibility-checker-f3cf3abc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tvv88m9G5TesJMTUfUlB5

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-compatibility-checker-f3cf3abc -d '<json body>'
```

Example prompt: Check whether my agent tool schemas are compatible with OpenAPI 3.0 — here are my tool definitions: [{"name": "get_weather", "description": "Returns current weather", "parameters": {"type": "object", "properties": {"location": {"type": ["string", "null"]}}}}]. Give me a score and tell me what needs to be fixed.

## When to prefer this

Use this endpoint when you need programmatic, per-issue feedback on AI agent tool schema compatibility with a specific dialect (draft-07, 2020-12, openapi-3.0, openapi-3.1) before deploying to an agent runtime. It is especially valuable when debugging tool rejection errors, migrating schemas between dialects, or running automated CI checks on tool definitions. Prefer this over manual review when you have multiple tools to audit at once and need machine-readable severity scores and suggested fixes.

## Known failure modes

- Malformed or non-object JSON in tool schema fields returns a validation error
- Unsupported target dialect enum value returns an error
- Exceeding 80 tools or 80 schemas per request may be rejected
- Schema URLs referenced inside schemas are not fetched — only supplied JSON is analyzed
- Non-standard JSON Schema drafts beyond the four supported dialects return limited analysis

## 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 numeric compatibility score (0-100), a list of issues each with type, location, severity, evidence snippet, description, and suggested fix, a list of warnings for non-fatal concerns like dialect mismatches, and a plain-English analysis summary string. High-severity issues indicate constructs the target dialect will likely reject; warnings are advisory.

## 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
  },
  "target": {
   "enum": [
    "draft-07",
    "2020-12",
    "openapi-3.0",
    "openapi-3.1"
   ],
   "type": "string"
  },
  "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": 44,
  "issues": [
   {
    "type": "unsupported_keyword",
    "evidence": "prefixItems",
    "location": "tools[0].parameters",
    "severity": "high",
    "description": "prefixItems is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.",
    "suggested_fix": "Remove prefixItems or convert it to a construct openapi-3.0 allows."
   },
   {
    "type": "unsupported_keyword",
    "evidence": "$schema",
    "location": "tools[0].parameters",
    "severity": "high",
    "description": "$schema is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.",
    "suggested_fix": "Remove $schema or convert it to a construct openapi-3.0 allows."
   },
   {
    "type": "unsupported_keyword",
    "evidence": "const",
    "location": "tools[0].parameters",
    "severity": "high",
    "description": "const is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.",
    "suggested_fix": "Remove const or convert it to a construct openapi-3.0 allows."
   },
   {
    "type": "type_array",
    "evidence": "[\"string\",\"null\"]",
    "location": "tools[0].parameters",
    "severity": "high",
    "description": "openapi-3.0 expects type to be a single string. An array of types can be dropped or rejected.",
    "suggested_fix": "Use nullable: true instead of a type array that includes null."
   },
   {
    "type": "null_type",
    "evidence": "null",
    "location": "tools[0].parameters",
    "severity": "high",
    "description": "OpenAPI 3.0 has no null type. Use nullable instead.",
    "suggested_fix": "Set nullable: true and remove null from type."
   }
  ],
  "success": true,
  "analysis": "Compared 1 schemas with openapi-3.0.",
  "warnings": [
   {
    "type": "dialect_mismatch",
    "location": "tools[0].parameters",
    "description": "$schema says https://json-schema.org/draft/2020-12/schema, which does not name the selected target."
   }
  ],
  "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. Other drafts are reported only when a keyword is on the target ban list.",
   "Example validation understands type, enum, const, properties, required, additionalProperties as a boolean, items, numeric and length bounds, and anyOf, oneOf, an
… (truncated)
```

## More

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