Catalog / tool-definition-check
LLM tool definition check
Checks an AI tool definition for OpenAI, Anthropic or MCP before you register it, and lists every problem with where it is and what is expected.
Benched Security-tested against the seller traps of our Agent Benchmark Exam.
Buy $1.00What it does
Statically checks one LLM tool (function-calling) definition in OpenAI (Chat Completions, Responses API, legacy functions), Anthropic or MCP shape and answers whether the provider accepts it: valid true/false, and each problem with severity, code, JSON Pointer path, message and the expected form. Errors: rules the providers document (OpenAI Chat name ^[a-zA-Z0-9_-]{1,64}$, Anthropic name ^[a-zA-Z0-9_-]{1,128}$, top-level type "object", wrapper fields and types; with strict: true the OpenAI and Anthropic strict-mode rules and keywords Anthropic answers with a 400) and schemas the JSON Schema meta-schema rejects (keyword types, unique type, required and enum entries). Dialect: Anthropic always 2020-12. MCP and OpenAI follow a root $schema of draft-04, -06, -07, 2019-09 or 2020-12 (MCP default 2020-12): a construct the declared draft allows (items as an array, $id "#a", boolean exclusiveMinimum) is never an error, and one only 2020-12 rejects is a warning. OpenAI without $schema: 2020-12 rules, but what an earlier draft allows is a warning. Warnings: what the docs leave open (MCP SHOULD name rules, Responses and custom tool names, missing description, undefined required names outside OpenAI strict, unknown keys, nulls read as absent as in SDK model_dump() output). Branch properties of allOf/anyOf/oneOf are merged recursively. Built-in tools are recognised, not checked. Pages of up to 50 problems (offset), complete counts. Limits: 100,000 characters, 5000 schemas, nesting 32. $ref is not resolved.
- Example input
{"tool_definition":"{\"type\":\"function\",\"function\":{\"name\":\"get_weather\",\"description\":\"Current weather for a city\",\"strict\":true,\"parameters\":{\"type\":\"object\",\"properties\":{\"city\":{\"type\":\"string\"},\"unit\":{\"type\":\"string\",\"enum\":[\"c\",\"f\"]}},\"required\":[\"city\",\"country\"],\"additionalProperties\":false}}}","format":"openai"}- Answer
{"ok":true,"result":{"valid":false,"reason":"definition_has_errors","format":"openai","shape":"chat_completions","tool_name":"get_weather","strict_mode":"on","dialect":"2020-12, earlier drafts as warnings","error_count":2,"warning_count":0,"problems_total":2,"offset":0,"problems":[{"severity":"error","code":"required_not_in_properties","path":"/function/parameters/required/1","path_truncated":false,"message":"The required name is not in properties and additionalProperties is false; OpenAI strict mode needs it defined.","expected":"the name defined in properties, or removed from required"},{"severity":"error","code":"strict_property_not_required","path":"/function/parameters/properties/unit","path_truncated":false,"message":"With strict: true, OpenAI strict mode requires every property to be listed in required.","expected":"the name in required; type [\"...\", \"null\"] for an optional value"}],"problems_truncated":false,"next_offset":null,"parameter_count":2,"required_count":2,"standard":"OpenAI Chat Completions and Responses API references, function-calling guide; JSON Schema meta-schemas"},"warnings":[]}- Try it free
- /try/tool-definition-check
Buy
Price $1.00, once. One buyer only: the first one owns the tool, we stop selling it and list your copy, and every paid call to it goes to your wallet. Comes with a licence: run it, change it and earn from it; the code itself is not passed on or resold.
- Pay with an x402 walletThe buy link is
https://forge.fizzl.eu/forge/packages/tool-definition-check?format=zip. It answers with a payment request (HTTP 402) that an x402 wallet pays in USDC on Base. From Claude, ChatGPT or Grok with the Fizzl Agent Wallet: ask “buy https://forge.fizzl.eu/forge/packages/tool-definition-check?format=zip”. From code:const pay = wrapFetchWithPayment(fetch, client); // see /llms.txt const zip = await pay("https://forge.fizzl.eu/forge/packages/tool-definition-check?format=zip"); - Start it with your walletUnzip,
npm install, thenPAY_TO=0xYourWallet PUBLIC_URL=https://your-host npm starton any Node host. - We list it for youYour copy tells us where it runs; we check it and add it to the x402 Trust Index and the Bazaar under your wallet.
Bought it, and something is wrong?
Paste the receipt you got with the purchase (the X-Forge-Receipt token; a bundle receipt works too) and say what is wrong. Free. We pick it up within the hour; a real fault is fixed, passes the same checks, and you download the new version free at /forge/packages/tool-definition-check/update with your receipt. No money back through this form.
Missing a tool?
Tell us in one sentence what it should do: what goes in, what comes out. Free, no wallet. Our agents read every suggestion and build the useful ones in the next shift. Want it for sure? Order it for $1.