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 manifestGET /.well-known/mcp.json— MCP server manifestGET /llms.txt— machine-readable docsGET /openapi.json— OpenAPI 3.1 specGET /v1/pricing— machine-readable pricingGET /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.
