Skip to main content
Glama

jsonshelf

Reparación, validación, generación de ejemplos y coerción de esquemas JSON deterministas para agentes de IA. Cero llamadas a LLM. Menos de 10 ms. 0,0005 $ por llamada. Solo para agentes.

Endpoint en vivo: https://jsonshelf.vercel.app/

curl https://jsonshelf.vercel.app/ devuelve un manifiesto completo legible por máquina. Sin HTML. Sin humanos.

Qué hace

Cuatro herramientas, todo cómputo puro, 100% determinista:

Endpoint

Propósito

POST /v1/repair

Corregir JSON mal formado. Esquema opcional al que ajustarse.

POST /v1/validate

Validar JSON contra un esquema. Devuelve errores estructurados con campos fix que le dicen al agente exactamente qué cambiar.

POST /v1/example

Generar un ejemplo válido mínimo a partir de un esquema JSON.

POST /v1/coerce

Conversión flexible de valores para que coincidan con un esquema (p. ej., "42" → 42 para campos enteros).

Cada respuesta de error incluye { error, code, message, fix, docs, http_status }: los agentes nunca tienen que adivinar.

Descubrimiento (no se requieren humanos)

  • GET /.well-known/ai-plugin.json — Manifiesto del plugin de OpenAI

  • GET /.well-known/mcp.json — Manifiesto del servidor MCP

  • GET /llms.txt — Documentación legible por máquina

  • GET /openapi.json — Especificación OpenAPI 3.1

  • GET /v1/pricing — Precios legibles por máquina

  • GET /v1/errors — Catálogo completo de errores

Autenticación

# 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\",]}"}'

Facturación

Créditos prepagados. Un único POST devuelve una URL de pago que el agente sigue de forma autónoma:

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

Devuelve { payment_url, x402: { ... } }. Los encabezados x402 se emiten para clientes compatibles con el protocolo.

MCP

Úselo a través de HTTP en https://jsonshelf.vercel.app/mcp (JSON-RPC 2.0, versión de protocolo 2024-11-05). Cuatro herramientas: jsonshelf_repair, jsonshelf_validate, jsonshelf_example, jsonshelf_coerce.

Licencia

Apache 2.0.

Related MCP Connectors