{"uid":"cap_Tvv88m9G5TesJMTUfUlB5","slug":"brainiac-tool-schema-compatibility-checker-f3cf3abc","name":"BRAINIAC Tool Schema Compatibility Checker","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-compatibility-check?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},"target":{"enum":["draft-07","2020-12","openapi-3.0","openapi-3.1"],"type":"string"},"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":44,"issues":[{"type":"unsupported_keyword","evidence":"prefixItems","location":"tools[0].parameters","severity":"high","description":"prefixItems is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.","suggested_fix":"Remove prefixItems or convert it to a construct openapi-3.0 allows."},{"type":"unsupported_keyword","evidence":"$schema","location":"tools[0].parameters","severity":"high","description":"$schema is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.","suggested_fix":"Remove $schema or convert it to a construct openapi-3.0 allows."},{"type":"unsupported_keyword","evidence":"const","location":"tools[0].parameters","severity":"high","description":"const is not part of openapi-3.0. An agent runtime that only accepts that dialect can reject the tool.","suggested_fix":"Remove const or convert it to a construct openapi-3.0 allows."},{"type":"type_array","evidence":"[\"string\",\"null\"]","location":"tools[0].parameters","severity":"high","description":"openapi-3.0 expects type to be a single string. An array of types can be dropped or rejected.","suggested_fix":"Use nullable: true instead of a type array that includes null."},{"type":"null_type","evidence":"null","location":"tools[0].parameters","severity":"high","description":"OpenAPI 3.0 has no null type. Use nullable instead.","suggested_fix":"Set nullable: true and remove null from type."}],"success":true,"analysis":"Compared 1 schemas with openapi-3.0.","warnings":[{"type":"dialect_mismatch","location":"tools[0].parameters","description":"$schema says https://json-schema.org/draft/2020-12/schema, which does not name the selected target."}],"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.","The selected target is openapi-3.0. A keyword on that target's ban list subtracts 12. A type-array, null type, or exclusive bound mismatch subtracts 10.","Absence of a finding does not mean the schema is accepted by every agent SDK."],"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_knsBl41DJEZ6TmrCna4fD","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 against a target JSON Schema or OpenAPI dialect, returning a compatibility score and actionable issue list","exampleAgentPrompt":"Check whether my agent tool schemas are compatible with OpenAPI 3.0 — here are my tool definitions: [{\"name\": \"get_weather\", \"description\": \"Returns current weather\", \"parameters\": {\"type\": \"object\", \"properties\": {\"location\": {\"type\": [\"string\", \"null\"]}}}}]. Give me a score and tell me what needs to be fixed.","exampleUseCases":[{"title":"Pre-deployment MCP tool audit","prompt":"Before I ship my MCP server, can you run a compatibility check on all my tool schemas against openapi-3.1 and tell me which ones have issues and how to fix them?"},{"title":"Debugging rejected agent tool","prompt":"My agent tool keeps getting rejected by the runtime — can you check this tool schema against openapi-3.0 and tell me exactly what keywords or patterns are causing the problem?"},{"title":"JSON Schema to OpenAPI migration check","prompt":"I'm migrating my tool definitions from JSON Schema 2020-12 to openapi-3.0 — can you validate these schemas and flag anything that won't be supported in OpenAPI 3.0 so I know what to convert?"}],"resultDescription":"Returns a numeric compatibility score (0-100), a list of issues each with type, location, severity, evidence snippet, description, and suggested fix, a list of warnings for non-fatal concerns like dialect mismatches, and a plain-English analysis summary string. High-severity issues indicate constructs the target dialect will likely reject; warnings are advisory.","failureModes":["Malformed or non-object JSON in tool schema fields returns a validation error","Unsupported target dialect enum value returns an error","Exceeding 80 tools or 80 schemas per request may be rejected","Schema URLs referenced inside schemas are not fetched — only supplied JSON is analyzed","Non-standard JSON Schema drafts beyond the four supported dialects return limited analysis"],"whenToPreferThis":"Use this endpoint when you need programmatic, per-issue feedback on AI agent tool schema compatibility with a specific dialect (draft-07, 2020-12, openapi-3.0, openapi-3.1) before deploying to an agent runtime. It is especially valuable when debugging tool rejection errors, migrating schemas between dialects, or running automated CI checks on tool definitions. Prefer this over manual review when you have multiple tools to audit at once and need machine-readable severity scores and suggested fixes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:54.748Z","isFirstParty":false,"canonicalSlug":"brainiac-tool-schema-compatibility-checker-f3cf3abc"}