Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man json-schema-validate

/json-schema-validate

agentutility / wordmint / json-schema-validate
PRICE / CALL
$0.003
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
wordmint
CATEGORY
ai
STATUS
● live
NAME
json-schema-validate — validates any json document against any json schema, draft-07 or 2020-12
SYNOPSIS
POST https://x402.agentutility.ai/json-schema-validate
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Validates any JSON document against any JSON Schema, draft-07 or 2020-12. Returns valid boolean, total error count, and per-error instance_path + schema_path + keyword + message. Powered by @cfworker/json-schema (MIT), a spec-walker validator with built-in format keyword support (email / uri / date / uuid / etc.). Check whether an LLM's structured output matches the spec you asked for, validate an API response against your documented schema, or add a verification gate to an agent pipeline. 200KB schema cap + 500KB data cap keep CPU bounded. Use it as a JSON Schema validator, JSON validator, structured-output verifier, or contract checker.

INPUT — request schema
propertytypedescriptionreq?
schemaobjectThe JSON Schema document. Max 200,000 chars when stringified.required
dataanyThe JSON data to validate. Any value. Max 500,000 chars when stringified.required
draftstringSchema draft: '2020-12' (default) or 'draft-07'.optional
valid_onlybooleanIf true, skips per-error detail and returns only { valid, error_count }. Default false.optional
formatsbooleanDeprecated no-op; format keywords (email, date, uri, uuid, etc.) are always validated. Accepted for backward compatibility.optional
OUTPUT — response shape
fieldtypedescription
validbooleanTrue when the data passed every constraint in the schema.
draftstringEcho of which JSON Schema draft was used.
error_countnumberTotal ajv errors raised before truncation.
truncatedbooleanTrue when error_count exceeded the 100-error cap and the errors array was trimmed.
errorsarrayPer-error detail: instance_path (JSON pointer into the data), schema_path (JSON pointer into the schema), keyword (the constraint that failed), message (ajv's human-readable string), params (constraint-specific extras). Empty when valid_only is true.
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/json-schema-validate \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the json-schema-validate tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
wordmintjson-schemavalidationschema-validateajvstructured-output
methods
POST
cluster
wordmint
price
$0.003 USDC per call
ADJACENT — other endpoints in wordmint
endpointdescriptionprice
cron-nextTells you exactly when a cron expression fires next.$0.003
contract-translateTranslates contract excerpts and commercial terms, preserving numbering, defined terms, clause references, dates, and party names.$0.002
cron-explainCron expression parser.$0.002
customer-review-translateTranslates customer reviews, ratings comments, and voice-of-customer excerpts, preserving product names, SKUs, and star ratings.$0.002
education-course-translateTranslates course outlines, assignments, quiz instructions, and LMS copy, preserving placeholders and numbering.$0.002
finance-report-translateTranslates finance reports: market commentary, investor letters, earnings notes, and finance summaries, preserving tickers and numbers.$0.002
game-localization-translateTranslates game content: dialogue, item descriptions, UI strings, and patch notes, preserving tokens.$0.002
immigration-document-translateTranslates immigration form excerpts, appointment instructions, evidence checklists, and application notes, preserving names, dates, IDs,…$0.002
SEE ALSO
agentutility · wordmint · x402 · mcp · llms.txt · registry.json · bazaar.x402.org