Carboncillo para desarrolladores y agentes de IA

El catálogo de Carboncillo se puede consultar sin registro y sin clave. Es de solo lectura: nada de lo que sigue crea pedidos ni pide datos personales. La compra se hace en la web.

1. Servidor MCP (recomendado para agentes)

Endpoint: POST https://carboncillo.com/mcp, transporte Streamable HTTP, sin autenticación. Seis herramientas: buscar productos, ver un producto, listar categorías, productos de una categoría, guías de compra, y envíos y devoluciones. Para conectarlo a Claude, ChatGPT o Grok, abre /mcp en el navegador.

claude mcp add --transport http carboncillo https://carboncillo.com/mcp

Habla las dos eras del protocolo: initialize y metadatos por petición (2026-07-28). Tarjeta de descubrimiento: /.well-known/mcp/server-card.json. En navegadores con WebMCP, las mismas herramientas se registran en cada página.

2. API REST y OpenAPI

Especificación OpenAPI 3.1: /openapi.json. Tres rutas:

  • GET /api/products: búsqueda y filtros por texto, categoría, marca y precio.
  • GET /api/products/{slug}: ficha de un producto y cuatro relacionados.
  • GET /api/categories: árbol de categorías, o lista plana con ?flat=true.

Los errores de /api/ son JSON: {"error":{"status","code","message","hint"}}.

3. Contexto para modelos

  • /llms.txt: qué es la tienda, cuándo usarla, envíos, devoluciones y guías.
  • /llms-full.txt: listado largo de categorías y marcas.
  • Cualquier página responde en markdown si se pide con Accept: text/markdown. La respuesta lleva Vary: Accept.

Límites

  • El servidor MCP admite 60 peticiones por minuto y por IP. Las cabeceras RateLimit-* dicen cuántas quedan; un 429 trae Retry-After.
  • Precios en euros con IVA. Solo se devuelven productos activos y visibles.
  • Dudas o integraciones: contacto.