B2B SublimaciónVenta de insumos e interiores sublimables para revendedores en Uruguay.
🎁 ¿Buscas productos ya personalizados? Visita www.papeleriapersonalizada.uy
Agent-Ready • Model Context Protocol & REST API

Portal de Desarrolladores & Agentes de IA

Bienvenido al portal oficial de ingeniería de Kamaluso Papelería Sublimable (San José de Mayo, Uruguay). Nuestra plataforma ofrece integración sin fricción (Zero-Auth en catálogo público), especificación formal OpenAPI 3.1, servidor Model Context Protocol (MCP) y documentación nativa para modelos de lenguaje en llms.txt.

Zero-Auth Public API

El catálogo completo de insumos, stock y precios en UYU está disponible de forma abierta sin requerir API keys ni registros obligatorios.

GET /api/products

MCP Streamable HTTP

Servidor Model Context Protocol completo (JSON-RPC 2.0) para agentes Claude, Gemini, Antigravity y Cursor con herramientas de búsqueda y pedidos.

POST /api/mcp

Rate Limits & Errores RFC 9457

Cabeceras estándar IETF RateLimit (120 req/min) y respuestas de error estructuradas con formato RFC 9457 application/problem+json.

RateLimit-Limit: 120

Guía de Inicio Rápido (Quickstart)

1. Consultar catálogo en cURL

curl -X GET "https://www.kamaluso.com/api/products" \
  -H "Accept: application/json"

2. Consultar catálogo en Python

import requests

res = requests.get("https://www.kamaluso.com/api/products")
products = res.json()
print(f"Total productos disponibles: {len(products)}")
for p in products[:3]:
    print(f"- {p['name']}: ${p['price']} UYU")

3. Conexión Model Context Protocol (MCP) en Claude Desktop / Antigravity

{
  "mcpServers": {
    "kamaluso": {
      "url": "https://www.kamaluso.com/api/mcp"
    }
  }
}

Endpoints Principales

GET/api/products(Alias: /api/v1/products)

Retorna la lista de productos e insumos sublimables con precios, fotos WebP/AVIF optimizadas, descripción, stock y categorías.

POST/api/orders(Alias: /api/v1/orders)

Registra un pedido mayorista o minorista con lista de artículos, agencia de transporte en Uruguay y método de pago en UYU.

POST/api/mcp

Protocolo Model Context Protocol (Streamable HTTP / JSON-RPC 2.0). Soporta herramientas: search_products, get_product_details, get_sublimation_parameters.

GET/api/health

Healthcheck y estado del cluster en Vercel Edge con tiempo de respuesta y uptime.

Contacto y Soporte para Desarrolladores

¿Estás integrando un agente de compras, un sistema ERP para imprentas o un plugin personalizado? Nuestro equipo técnico te brinda soporte directo.

Email: kamalusosanjose@gmail.comWhatsApp Técnico: +598 98 615 074Ubicación: San José de Mayo, Uruguay
098 615 074