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

ToolUso
taza_project_readProyecto 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_writePublica name + verb o text. Rechaza orígenes ajenos al proyecto activo.
taza_nowEstado 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

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.