Desarrolladores

Qué hay

Todo Tidbit se puede leer con código y sin cuenta: una API JSON estática, la versión Markdown de cada página y un servidor MCP para agentes de IA. Todo es de solo lectura, gratis y con CORS abierto. El contenido tiene licencia MIT: si lo mostrás, linkeá la entrada.

API JSON

https://tidbit.legios.com.ar/v1/terms.json lista todos los términos con su definición de una línea, alias, nivel, temas y URLs en los dos idiomas. https://tidbit.legios.com.ar/v1/terms/<slug>.json trae la entrada completa. El esquema está en https://tidbit.legios.com.ar/openapi.json.

curl -s https://tidbit.legios.com.ar/v1/terms.json | jq '.terms[] | {slug, title: .en.title}'
curl -s https://tidbit.legios.com.ar/v1/terms/data-lake.json | jq '.es.tagline'

Markdown

Cualquier página devuelve Markdown si la pedís con Accept: text/markdown, o agregando index.md a su URL. Los 404 también responden en Markdown cuando lo pedís.

curl -s -H 'Accept: text/markdown' https://tidbit.legios.com.ar/es/data-lake/

Servidor MCP

https://tidbit.legios.com.ar/mcp es un servidor MCP (Streamable HTTP, sin autenticación) con cuatro herramientas de solo lectura: search_terms, get_term, list_topic y term_of_the_day. Agregalo a cualquier cliente MCP con esta configuración. El server card está en https://tidbit.legios.com.ar/.well-known/mcp/server-card.json.

{
  "mcpServers": {
    "tidbit": {
      "type": "http",
      "url": "https://tidbit.legios.com.ar/mcp"
    }
  }
}

Errores

Los errores de la API y del servidor MCP son JSON. La API usa RFC 9457 (application/problem+json) con un code legible por máquinas (not_found, rate_limited, method_not_allowed), un mensaje y qué hacer después. MCP usa los errores de JSON-RPC.

{
  "type": "https://tidbit.legios.com.ar/developers/#errors",
  "title": "Term not found",
  "status": 404,
  "code": "not_found",
  "detail": "No term has the slug 'foo'.",
  "resolution": "List every term at https://tidbit.legios.com.ar/v1/terms.json."
}

Límites de uso

Uso justo: 300 pedidos cada 60 segundos por cliente para /v1/ y /mcp, aplicado de forma aproximada. Cada respuesta trae los headers RateLimit-Policy y RateLimit; al pasarte recibís 429 con Retry-After. Para bajar todo de una vez, usá https://tidbit.legios.com.ar/v1/terms.json o https://tidbit.legios.com.ar/llms-full.txt en vez de pedir término por término.

Versiones

La versión va en la ruta (/v1/). Dentro de una versión solo se agregan campos, nunca se sacan ni cambian de significado. Un cambio incompatible sale como /v2/, y /v1/ sigue funcionando al menos 12 meses después, avisado con los headers Deprecation y Sunset y en esta página.

Ayuda

Preguntas, errores o pedidos de términos: https://github.com/legiosai/tidbit/issues. La guía para agentes está en https://tidbit.legios.com.ar/llms.txt.