{"uid":"cap_NEa2R4TB-OMS2yESGiLmw","slug":"brainiac-agent-tool-schema-validator-cbffebbd","name":"BRAINIAC Agent Tool Schema Validator","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-example-validate?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":50,"issues":[{"type":"additional_property","evidence":"note","location":"tools[0].examples[0]","severity":"medium","description":"The example includes a field the schema rejects.","suggested_fix":"Remove note or declare it in properties."},{"type":"min_length","evidence":"1 < 2","location":"tools[0].examples[0].sku","severity":"medium","description":"The example is shorter than minLength.","suggested_fix":"Use at least 2 characters."},"…"],"success":true,"analysis":"Checked 2 examples. 1 matched the declared schema.","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":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hJafuiFK3f255PoEtKG5R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates AI agent tool schemas and their examples against JSON Schema constraints, returning a score and detailed issue list","exampleAgentPrompt":"Can you validate this agent tool schema for me — I have a tool called 'lookup_product' with an inputSchema requiring name and sku (minLength 2), and two examples: one with sku='A' and an extra 'note' field that's not in the schema? I want to know the score and what's wrong.","exampleUseCases":[{"title":"Pre-deploy agent tool QA check","prompt":"Before I ship this new 'create_order' tool, can you validate its schema and examples? The inputSchema requires quantity (minimum 1) and product_id, and I have three examples I want verified — tell me the score and flag any issues with types, missing fields, or extra properties."},{"title":"OpenAPI spec example audit","prompt":"I've got an OpenAPI 3.1 spec with a few endpoints and example payloads — can you check whether all the examples actually conform to their declared schemas and give me a list of violations with suggested fixes?"},{"title":"Debugging schema rejection errors","prompt":"My agent tool 'search_inventory' keeps getting flagged for schema mismatches. Here's the tool definition with its inputSchema and three examples — can you score it and tell me exactly which examples fail and why, including the specific keyword that's violated?"}],"resultDescription":"A JSON object containing: a numeric score (0–100, percentage of examples passing validation), a boolean success flag, an analysis string summarizing how many examples were checked and how many passed, an issues array with each issue's type, location (e.g. tools[0].examples[0].sku), severity (medium/high), evidence, description, and suggested fix, plus warnings, limitations, and recommendations arrays.","failureModes":["Malformed JSON input returns an error without a score","$ref pointers to external URLs are not resolved and are reported as failures","Unsupported JSON Schema dialects may only partially validate","Empty tools array results in no examples checked and no score returned","Schema with no examples produces analysis but omits score field","Input exceeding maxItems (80 tools or 80 schemas) may be rejected or truncated"],"whenToPreferThis":"Use this endpoint when you need to programmatically verify that AI agent tool definitions — including their examples — conform to their declared JSON Schema or OpenAPI schemas. It is purpose-built for agent tooling validation (not general-purpose JSON linting) and returns structured, machine-readable issues with locations and fix suggestions. Prefer this over manual review or generic JSON validators when you need a numeric quality score, severity-tagged issues, and fix recommendations across multiple tools in one call, especially when working with draft-07, 2020-12, OpenAPI 3.0, or 3.1 schemas.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:31.939Z","isFirstParty":false,"canonicalSlug":"brainiac-agent-tool-schema-validator-cbffebbd"}