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.
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.
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.
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
Retorna la lista de productos e insumos sublimables con precios, fotos WebP/AVIF optimizadas, descripción, stock y categorías.
Registra un pedido mayorista o minorista con lista de artículos, agencia de transporte en Uruguay y método de pago en UYU.
Protocolo Model Context Protocol (Streamable HTTP / JSON-RPC 2.0). Soporta herramientas: search_products, get_product_details, get_sublimation_parameters.
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.
