{"uid":"cap_Dlq8dXUxkPf5VwXgGwNry","slug":"brainiac-tool-schema-linter-f8d21933","name":"BRAINIAC Tool Schema Linter","description":"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.","url":"https://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-lint?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QbnO_CkRuK8z-2ofhzaNJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lints AI agent tool schemas and OpenAPI specs for structural errors, returning scored issues with severity and suggested fixes","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-deploy MCP tool validation","prompt":"Before I publish my MCP server, can you lint these tool definitions for me and flag anything that would confuse an AI agent? I want to know the score and see any high-severity issues with suggested fixes."},{"title":"OpenAPI spec agent-compatibility check","prompt":"I have an OpenAPI 3.1 spec I want to expose as agent tools — can you run it through the tool schema linter and tell me if there are any structural problems like missing required fields, duplicate names, or enum mismatches?"},{"title":"Debugging broken agent tool behavior","prompt":"My agent keeps failing when it tries to call my 'get_invoice' tool — can you lint the tool schema to see if there's a problem like a required field not in properties or a type mismatch in an enum value?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T14:19:12.905Z","isFirstParty":false,"canonicalSlug":"brainiac-tool-schema-linter-f8d21933"}