{"uid":"cap_80RrZdAGR8786n0lE-u8H","slug":"brainiac-tool-schema-required-field-audit-b24e6bcb","name":"BRAINIAC Tool Schema Required Field Audit","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-required-field-audit?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":81,"issues":[{"type":"duplicate_required","evidence":"sku","location":"tools[0].parameters.required","severity":"low","description":"The required array lists the same field twice.","suggested_fix":"List each required field once."},{"type":"required_missing_property","evidence":"quantity","location":"tools[0].parameters.required","severity":"high","description":"The agent is required to send a field that is not defined.","suggested_fix":"Define properties.quantity or stop requiring it."}],"success":true,"analysis":"Audited required arrays on 1 tools.","warnings":[{"type":"required_has_default","location":"tools[0].parameters.properties.sku","description":"sku is required and also has a default. Agents may disagree about whether to send it."},{"type":"required_has_default","location":"tools[0].parameters.properties.sku","description":"sku is required and also has a default. Agents may disagree about whether to send it."}],"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":[]}},"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_hRCcarQeSyCw4aY-2rTWa","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":"Audits the `required` arrays in AI agent tool schemas to detect missing property definitions, duplicates, and other structural issues that cause agent misbehavior.","exampleAgentPrompt":"Can you audit these two tool definitions for required-field problems — I want to know if any required fields are missing from properties, if there are duplicates, and get an overall quality score back so I can fix issues before shipping.","exampleUseCases":[{"title":"Pre-deploy tool schema quality check","prompt":"Before I publish my AI agent's tool definitions, run a required-field audit on all 5 of them and tell me which fields are required but not defined in properties, any duplicates in the required arrays, and what score I get overall."},{"title":"OpenAPI spec required field review","prompt":"I have an OpenAPI spec for my agent toolkit — can you check the required arrays in every endpoint's request schema for missing property definitions or duplicates and give me a list of issues with suggested fixes?"},{"title":"Debugging agent tool call failures","prompt":"My AI agent keeps failing when it tries to call my 'create_order' tool — the schema has a required array. Can you audit it to see if any required fields aren't actually defined in properties, or if there are any duplicates causing the problem?"}],"resultDescription":"Returns a JSON object with: a numeric score (0–100) reflecting schema quality, a list of issues each with type, severity (high/low), location, evidence, description, and suggested fix, a list of warnings for non-score-impacting problems (e.g. defaults on required fields), an analysis summary string, limitations of the audit engine, and an empty or populated recommendations array.","failureModes":["Malformed JSON in input schema causes parsing error","Input exceeds 80 tools limit and is rejected","Tool name missing causes validation failure on required 'name' field","Schema dialect not supported leads to partial or skipped checks","$ref to external URLs not fetched — only same-document $defs resolved","Payment not completed via x402 results in 402 response and no audit"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic, structural audit of AI agent tool schemas focused specifically on `required` array correctness — detecting missing property definitions, duplicates, and problematic defaults. Prefer this over manual review or general JSON Schema validators when you want an agent-interpretable score, actionable issue list with severity and suggested fixes, and coverage across both JSON Schema (draft-07, 2020-12) and OpenAPI (3.0, 3.1) dialects. Best suited for CI pipelines, pre-deployment checks, or debugging agent tool call failures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T14:19:12.303Z","isFirstParty":false,"canonicalSlug":"brainiac-tool-schema-required-field-audit-b24e6bcb"}