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

/type-inference-from-json

agentutility / wordmint / type-inference-from-json
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
wordmint
CATEGORY
uncategorized
STATUS
live
NAME
type-inference-from-json infers type definitions from a json sample, converting json to typescript, zod, or json schema
SYNOPSIS
POST https://x402.agentutility.ai/type-inference-from-json
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Infers type definitions from a JSON sample, converting JSON to TypeScript, Zod, or JSON Schema. Paste a sample (or array of samples); returns a generated type definition in your chosen format. Merges across array elements / object samples: properties present in some but not all become optional, mixed primitive types become unions. Auto-detects string formats (date-time / uuid / uri / email) for richer outputs. Ideal inside agent code-gen loops that need to consume an unfamiliar API response. Use it as a JSON shape inferer or quicktype-style type generator.

INPUTrequest schema
propertytypedescriptionreq?
jsonstring | object | array | number | boolean | nullThe JSON sample to infer from. Accept a JSON string OR a pre-parsed object/array/primitive. Max 256 KB if passed as string.required
formatstringOutput format. Default 'typescript'.
enum: typescript · zod · jsonschema
optional
root_namestringName of the root type / interface / Zod export. Must be a valid JS identifier. Default 'Root'.optional
date_stringsbooleanIf true (default), recognize ISO-8601 date-time / UUID / URL / email strings and emit format-aware types. Set false to treat all strings as plain 'string'.optional
OUTPUTresponse shape
fieldtypedescription
formatstringOutput format requested: typescript, zod, json-schema, or similar.
root_namestringName used for the top-level generated type or schema (e.g. Root, User).
typesstringGenerated type definition source as a string in the requested format, ready to paste into code.
inferred_shapeobjectInternal shape tree with per-field types, optionality flags, and detected string formats before rendering.
sourcestringEcho of the input JSON sample (or array) that the types were inferred from.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/type-inference-from-json \
  -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 type-inference-from-json tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
jsontypescriptzodjson-schematype-inferencecodegenschema
methods
POST
cluster
wordmint
price
$0.005 USDC per call
ADJACENTother endpoints in wordmint
endpointdescriptionprice
brand-taglineGenerates brand taglines and slogans for launch pages, X bios, email copy, and product cards.$0.005
brand-tagline-generateGenerates tagline options for a brand or startup from its name, concept, audience, and tone.$0.005
card-resolveNormalizes free-form graded card text into a canonical card object.$0.005
content-simhashFingerprints text with a 64-bit SimHash for near-duplicate detection, computed entirely locally.$0.005
cron-parseCron parser.$0.005
detect-languageLanguage detector / language identification.$0.005
dictionary-defineLooks up English word definitions with pronunciation, part of speech, and synonyms.$0.005
embedding-similarityMeasures how semantically similar two strings are: embeds both via Venice (default model: text-embedding-bge-m3) and returns the cosine s…$0.005
SEE ALSO
agentutility · wordmint · x402 · mcp · llms.txt · registry.json · bazaar.x402.org