# BRAINIAC Tool Schema Linter

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

Lints AI agent tool schemas and OpenAPI specs for structural errors, returning scored issues with severity and suggested fixes

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-lint?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-linter-f8d21933
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dlq8dXUxkPf5VwXgGwNry

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-linter-f8d21933 -d '<json body>'
```

Example prompt: Can you lint my agent tool definitions and tell me what's wrong? Here are the tools: [{"name": "search_orders", "description": "Search orders by customer email", "parameters": {"type": "object", "properties": {"email": {"type": "string"}}, "required": ["email", "limit"]}}] — I want a score and a list of issues with fixes.

## When to prefer this

Use this endpoint when you need automated, deterministic structural linting of agent tool schemas or OpenAPI specs before deployment — especially to catch agent-breaking issues like duplicate tool names, required fields missing from properties, enum type mismatches, and unknown types. Prefer this over manual review or LLM-based schema critique when you need a reproducible quality score and machine-readable issue list with specific fix suggestions.

## Known failure modes

- Malformed JSON input returns a parse error
- Tool array exceeding 80 items is rejected
- Property names exceeding 80 characters fail validation
- External $ref URLs are not resolved — only local #/ pointers are followed
- Schema dialects outside draft-07, 2020-12, OpenAPI 3.0/3.1 may produce incomplete results
- Payment failure via x402 returns HTTP 402 and no lint result

## 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 quality score (0–100), an array of issues each with type, severity (high/medium/low), location in the schema, evidence, description, and suggested fix; a summary analysis string; warnings array; limitations list; and a success boolean.

## 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": 60,
  "issues": [
   {
    "type": "required_missing_property",
    "evidence": "limit",
    "location": "tools[0].parameters.required",
    "severity": "high",
    "description": "A required name is not in properties, so the agent is told to send a field that has no schema.",
    "suggested_fix": "Add properties.limit or remove limit from required."
   },
   {
    "type": "enum_type_mismatch",
    "evidence": "[1]",
    "location": "tools[0].parameters.properties.email",
    "severity": "medium",
    "description": "An enum value does not match the declared type, so a correct agent value can still be rejected.",
    "suggested_fix": "Make every enum value match type, or change type."
   },
   {
    "type": "duplicate_tool",
    "evidence": "search_orders",
    "location": "tools[0] and tools[1]",
    "severity": "high",
    "description": "Two tools share the same name, so an agent cannot choose between them by name.",
    "suggested_fix": "Rename one tool so each name is unique."
   }
  ],
  "success": true,
  "analysis": "Linted 2 tool or schema definitions.",
  "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. 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, and allOf. A $ref is resolved only inside the same document at #/$defs, #/definitions, or #/components/schemas.",
   "Local #/ pointers are followed into the supplied schema and OpenAPI document, including $defs, definitions, and components.schemas. External URLs are not.",
   "Score weights: duplicate tool 20, unknown type 15, properties not an object 15, required not an array of strings 15, required name missing 12, array without items 12, empty enum 12, enum type mismatch 8, bound conflict 8, external or non-string $ref 10.",
   "Warnings such as a missing type do not change the score."
  ],
  "recommendations": []
 }
}
```

## More

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