# BRAINIAC Tool Schema Overlap Detector

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

Detects naming conflicts, duplicate descriptions, and parameter overlap across a set of AI agent tool schemas to help avoid ambiguity

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-overlap-detect?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-overlap-detector-051ec4f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a8_aPY21P-hqTqr_D49C7

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-overlap-detector-051ec4f8 -d '<json body>'
```

Example prompt: Can you check my agent's tools for overlap or ambiguity? Here are the tool definitions — I want to know if any share identical or near-identical names and descriptions so my agent won't get confused about which one to call.

## When to prefer this

Use this endpoint when building or auditing AI agent toolsets where multiple tools exist and you need to ensure an LLM can unambiguously route to the correct tool. Especially valuable before deploying MCP servers or OpenAPI-defined agent toolkits where duplicate or vague descriptions cause silent routing errors. Prefer this over manual review for toolsets with more than 5 tools.

## Known failure modes

- Exceeding 80 tools in the input array may be rejected
- Descriptions shorter than 8 words may not trigger similarity checks due to minimum word-count requirements
- $ref resolution only works for local references (#/$defs, #/definitions, #/components/schemas); external URL refs are not fetched
- Non-standard JSON Schema drafts may not be fully supported
- Missing 'name' field on any tool object will cause a validation error

## 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 overlap score (0–100, lower is worse), a list of issues each with type, severity, location, evidence, description, and suggested fix, plus an analysis summary, warnings, limitations of the checker, and recommendations. Identical names or descriptions each subtract 20 points; similar descriptions subtract 10 points.

## 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": 80,
  "issues": [
   {
    "type": "identical_description",
    "evidence": "search customer orders by email address and return matching order records.",
    "location": "tools[0] and tools[1]",
    "severity": "high",
    "description": "The descriptions are the same text, so an agent has no way to choose between the tools.",
    "suggested_fix": "State the distinct case for each tool. This is an exact text match, not a keyword overlap."
   }
  ],
  "success": true,
  "analysis": "Compared 3 tools by exact name, exact description, a high word-overlap bar, and identical parameter lists.",
  "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-tool-schema-overlap-detector-051ec4f8/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)
