jsonshelf

Deterministic JSON repair, validation, example-generation, and schema-coercion for AI agents. Zero LLM calls. Sub-10ms. $0.0005 per call. Agents only.

Live endpoint: https://jsonshelf.vercel.app/

curl https://jsonshelf.vercel.app/ returns a full machine-readable manifest. No HTML. No humans.

What it does

Four tools, all pure compute, 100% deterministic:

Endpoint	Purpose
`POST /v1/repair`	Fix malformed JSON. Optional schema to conform to.
`POST /v1/validate`	Validate JSON against a schema. Returns structured errors with `fix` fields telling the agent exactly what to change.
`POST /v1/example`	Generate a minimal valid example from a JSON schema.
`POST /v1/coerce`	Soft-cast values to match a schema (e.g. `"42"` → `42` for integer fields).

Every error response includes { error, code, message, fix, docs, http_status } — agents never have to guess.

Discovery (no humans required)

GET /.well-known/ai-plugin.json — OpenAI plugin manifest
GET /.well-known/mcp.json — MCP server manifest
GET /llms.txt — machine-readable docs
GET /openapi.json — OpenAPI 3.1 spec
GET /v1/pricing — machine-readable pricing
GET /v1/errors — full error catalog

Auth

# 1. Issue a key (100 free credits)
curl -X POST https://jsonshelf.vercel.app/v1/keys

# 2. Use the key
curl -X POST https://jsonshelf.vercel.app/v1/repair \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input":"{name:\"alice\", skills:[\"code\",]}"}'

Billing

Prepaid credits. Single POST returns a payment URL the agent follows autonomously:

curl -X POST https://jsonshelf.vercel.app/v1/credits \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"pack":"starter"}'

Returns { payment_url, x402: { ... } }. x402 headers are emitted for protocol-compatible clients.

MCP

Use over HTTP at https://jsonshelf.vercel.app/mcp (JSON-RPC 2.0, protocol version 2024-11-05). Four tools: jsonshelf_repair, jsonshelf_validate, jsonshelf_example, jsonshelf_coerce.

License

Apache 2.0.

JSONShelf