PlayerTaza · MCP
Contrato público para conectar proyectos y elementos IoT con CarlosGdG.
Endpoint operativo JSON-RPC: https://ainimation.studio/taza/mcp
GET muestra esta guía. POST atiende MCP. Sin redirección para el endpoint canónico.
Conectar
{"mcpServers":{"playertaza":{"url":"https://ainimation.studio/taza/mcp"}}}Transporte HTTP; respuestas JSON o SSE según Accept. Ejecuta initialize, notifications/initialized y tools/list. No se necesita sesión MCP. El servidor acepta las versiones 2025-11-25, 2025-06-18, 2025-03-26 y 2024-11-05.
Herramientas principales
| Tool | Uso |
|---|
| taza_project_read | Proyecto activo, revisión y disponibilidad del puente. Solo lectura. |
| taza_status_read | Último contenido publicado y GIF; no prueba reproducción física. |
| taza_status_write | Publica name + verb o text. Rechaza orígenes ajenos al proyecto activo. |
| taza_now | Estado general. Los campos BLE/look heredados pueden ser históricos; no sustituyen al estado del puente ni la cámara. |
tools/list es la lista autoritativa. Herramientas manuales de píxeles y animaciones están restringidas cuando hay una asociación activa.
Aviso de gestión de colas
Primero selecciona Starbucks · Gestión de colas en el player. El productor no debe cambiar automáticamente el proyecto para forzar su mensaje.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "taza_status_write",
"arguments": {
"project": "starbucks-queue",
"via": "queue-follow",
"name": "PEDIDO 42",
"verb": "LISTO"
}
}
}Con CanalKiosk activo este mismo aviso devuelve isError:true, sin sustituir el contenido. CanalKiosk usa via=adcelerate-best y source=mappedMusic; Yarigai usa via=yarig. La asociación por pantalla se gestiona desde el player.
API HTTP equivalente
Base: https://playertaza.csilvasantin.workers.dev
- GET /api/store-binding: selección vigente.
- GET /api/mug-status: estado publicado.
- POST /api/mug-status: mismos argumentos que taza_status_write.
- POST /api/store-binding: configuración deliberada desde el player; storeId y screen.
Límite: una escritura cada 3 segundos. Ante retry_ms espera ese tiempo. Si bubble.queued=false revisa el error; una cola aceptada tampoco confirma LEDs. No reintentes un envío físico confirmado. El puente vuelve a intentar contenido pendiente al recuperarse mientras la consola sincroniza.
Seguridad y segmentación
El endpoint actual no exige OAuth: la selección filtra funcionalmente los proyectos, pero project/via son etiquetas declaradas, no credenciales de identidad. No distribuyas el token Bubble ni la clave del puente. Los productores deben enviar por esta API; una llamada directa a Bubble no pasa por sus filtros.
Contrato entre proyectos
Gestor de colas · Help · Gestor de colas · MCP. Integración del emisor pendiente hasta que esas rutas estén publicadas (404 al comprobar el 7 de octubre de 2026).
Manifest JSON · Guía para agentes · Ayuda operativa
Pedidos legibles · Readable pickup notices
Starbucks usa un fotograma fijo 32×16 con nombre centrado (hasta 8 caracteres) y el estado actual, con intensidad reducida. El nombre completo se conserva en el gestor y API. Evita desplazamientos y saltos del aviso. Verificación visual manual: pedido A002, Codex, comprobado en cámara.
Starbucks uses a static 32×16 frame with a centered name (up to 8 characters) and the current state at reduced intensity. Full names remain in the queue manager and API. Visual confirmation remains manual. Run /demo kiosko in admira.store for the guided order, simulated payment, queue and mug workflow; keep PlayerTaza open.
Estados del pedido · Order status
Nombre fijo arriba; estado debajo: RECIBIDO → PREPARANDO → LISTO. Cada fase previa a Listo dura 60 segundos desde el pago simulado, salvo avance manual del gestor. PlayerTaza sigue las tres listas y evita repetir el mismo estado. PREPARANDO usa espaciado compacto para caber completo en 32 píxeles.
Fixed name above the current state: RECIBIDO → PREPARANDO → LISTO. Each phase before Ready lasts 60 seconds after simulated payment unless manually advanced. Keep PlayerTaza open; it follows real queue transitions, not a separate timer.