⚡ MAURICIO Devs
100% Operacional
⬇️ Contexto IA
⚡ MODEL CONTEXT PROTOCOL (MCP 2024-11-05) • STREAMABLE HTTP

Conecta tus Agentes de IA a la Operación Real del Restaurante

MAURICIO expone un servidor MCP remoto Zero-Trust sobre HTTP con 18 Macro-Tools canónicas, 160 operaciones podadas de OpenAPI, 4 recursos pasivos, 7 slash prompts operativos y gobernanza Human-in-the-Loop de Dos Fases (2PC).

Macro-Tools Canónicas
18
Orden determinista alfanumérico
Operaciones Podadas
160
Vía Meta-Discovery / OpenAPI Profile
Clusters de Caché
5
Prompt Caching Invariance (~900 tok)
Gobernanza HITL
2PC + Undo
Confirmación visual & PIN supervisor

⚙️ Generador de Configuración para Clientes MCP (1 Clic)

Introduce tus credenciales para generar la configuración lista para copiar o instalar automáticamente con un clic en tu IDE o cliente agéntico.

⚡ Install in Cursor (1-Click) 
// Generando...
// Generando...
// Generando...
// Generando...
// Generando...

🛠️ Catálogo de Macro-Tools y Anotaciones Oficiales (18)

Herramientas de alto nivel diseñadas bajo el patrón de síntesis concisa (Terse Acknowledgement) para ahorrar tokens y garantizar seguridad Human-in-the-Loop.

Tier 1: Undoable booking booking:write

booking_concierge_create_or_modify_2pc

Crea o modifica una reservación con verificación de aforo por zona y genera preview_token 2PC para confirmación sin errores.

{
  "properties": {
    "area": {
      "default": "comedor_principal",
      "type": "string"
    },
    "covers": {
      "type": "integer"
    },
    "customer_name": {
      "type": "string"
    },
    "customer_phone": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "reservation_date_iso": {
      "type": "string"
    },
    "reservation_id": {
      "type": "string"
    }
  },
  "required": [
    "customer_name",
    "customer_phone",
    "reservation_date_iso",
    "covers"
  ],
  "type": "object"
}
Tier 0: Read Only booking booking:read

booking_crm_guest_360

Expediente integral del comensal: historial de visitas, consumo promedio (LTV), alérgenos, etiquetas VIP y preferencias de mesa.

{
  "properties": {
    "email": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    }
  },
  "type": "object"
}
Tier 1: Undoable booking booking:write

booking_seat_reservation_workflow

Recepción presencial (Check-In) de comensal con asignación de mesa física y emisión de undo_token de reversión.

{
  "properties": {
    "reservation_id": {
      "type": "string"
    },
    "table_identifier": {
      "type": "string"
    }
  },
  "required": [
    "reservation_id",
    "table_identifier"
  ],
  "type": "object"
}
Tier 2: 2-Phase Commit catalog catalog:write

catalog_86_omnichannel_cascade

Agotar un insumo/platillo (Acción 86): audita comandas abiertas afectadas, sugiere sustitutos y prepara preview_token 2PC.

{
  "properties": {
    "action": {
      "default": "86",
      "enum": [
        "86",
        "restore"
      ],
      "type": "string"
    },
    "product_identifier": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "product_identifier"
  ],
  "type": "object"
}
Tier 2: 2-Phase Commit catalog catalog:write

catalog_bulk_availability_2pc

Actualización masiva de disponibilidad de platillos por categoría (ej. menú degustación agotado) con confirmación 2PC.

{
  "properties": {
    "category_name": {
      "type": "string"
    },
    "is_available": {
      "type": "boolean"
    }
  },
  "required": [
    "category_name",
    "is_available"
  ],
  "type": "object"
}
Tier 0: Read Only catalog catalog:read

catalog_smart_search

Búsqueda semántica y difusa en la carta: platillos, precios, alérgenos, disponibilidad y maridajes recomendados.

{
  "properties": {
    "category": {
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "integer"
    },
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
Tier 2: 2-Phase Commit foodtech foodtech:write

foodtech_event_campaign_2pc

Publicación asistida de experiencias/eventos gastronómicos en el sitio web oficial con preview_token 2PC.

{
  "properties": {
    "action": {
      "enum": [
        "create",
        "publish",
        "archive"
      ],
      "type": "string"
    },
    "capacity": {
      "type": "integer"
    },
    "description": {
      "type": "string"
    },
    "event_id": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "starts_at_iso": {
      "type": "string"
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "action",
    "title",
    "starts_at_iso"
  ],
  "type": "object"
}
Tier 0: Read Only foodtech foodtech:read

foodtech_portal_status_360

Diagnóstico integral del portal web FoodTech: estado del sitio, eventos publicados, fechas próximas e identidad.

{
  "properties": {},
  "type": "object"
}
Tier 2: 2-Phase Commit foodtech foodtech:write

foodtech_site_quick_update_2pc

Actualización de identidad y contacto público de la sucursal con tarjeta diff y confirmación 2PC.

{
  "properties": {
    "reservation_public": {
      "type": "boolean"
    },
    "slogan": {
      "type": "string"
    }
  },
  "type": "object"
}
Tier 1: Undoable meta_discovery admin:write

mauricio_invoke_api

Ejecuta de manera segura una operación OpenAPI canónica de MAURICIO identificada por su 'operation_id'. Aplica automáticamente aislamiento RLS por sucursal, verificación de permisos RBAC y devuelve la respuesta estructurada estándar (RFC 7807 en caso de error).

{
  "properties": {
    "body": {
      "description": "Cuerpo JSON para peticiones POST/PUT/PATCH.",
      "type": "object"
    },
    "operation_id": {
      "description": "El operationId oficial obtenido previamente v\u00eda mauricio_search_api (ej. \u0027getPosLiveStatus\u0027, \u0027addPosOrderItems\u0027).",
      "type": "string"
    },
    "path_params": {
      "description": "Par\u00e1metros a incrustar en la URL (ej. {\u0027id\u0027: \u0027...\u0027} o {\u0027table_id\u0027: \u0027...\u0027}).",
      "type": "object"
    },
    "query_params": {
      "description": "Par\u00e1metros de consulta URL (ej. {\u0027compact\u0027: True, \u0027date\u0027: \u00272026-10-18\u0027}).",
      "type": "object"
    }
  },
  "required": [
    "operation_id"
  ],
  "type": "object"
}
Tier 0: Read Only meta_discovery admin:read

mauricio_search_api

Busca operaciones y esquemas de parámetros en la API OpenAPI de MAURICIO (~160 endpoints certificados). Úsala cuando necesites consultar datos específicos o ejecutar acciones no cubiertas por las Macro-Tools directas. Devuelve únicamente las operaciones que el usuario tiene permitido invocar según su rol (RBAC) en la sucursal activa.

{
  "properties": {
    "domain": {
      "description": "Filtro opcional por sub-dominio funcional.",
      "enum": [
        "pos_live",
        "pos_catalog",
        "booking",
        "foodtech"
      ],
      "type": "string"
    },
    "limit": {
      "default": 8,
      "description": "N\u00famero m\u00e1ximo de operaciones a retornar (m\u00e1x 15).",
      "type": "integer"
    },
    "method": {
      "description": "Filtro opcional por m\u00e9todo HTTP.",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ],
      "type": "string"
    },
    "query": {
      "description": "T\u00e9rmino de b\u00fasqueda o acci\u00f3n (ej. \u0027cancelar comanda\u0027, \u0027mesas ocupadas\u0027, \u0027eventos foodtech\u0027, \u0027disponibilidad\u0027).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
Tier 0: Read Only pos_live pos:read

pos_forensic_shift_auditor

Auditoría forense previa al cierre de turno: detecta mesas abiertas sin cobro, platillos pendientes y bloqueos para Ticket Z.

{
  "properties": {
    "terminal_id": {
      "type": "string"
    }
  },
  "type": "object"
}
Tier 0: Read Only pos_live pos:read

pos_live_pulse_360

Obtiene snapshot en vivo del piso, ocupación, ventas del turno, reservas de hoy y alertas proactivas de cuellos de botella.

{
  "properties": {
    "include_bottlenecks": {
      "default": true,
      "type": "boolean"
    }
  },
  "type": "object"
}
Tier 1: Undoable pos_live pos:write

pos_order_add_draft_items

Agrega platillos en borrador (PENDING) a una comanda. Devuelve chips interactivos 409 si el nombre es ambiguo y emite undo_token.

{
  "properties": {
    "items": {
      "items": {
        "properties": {
          "notes": {
            "type": "string"
          },
          "product_name": {
            "type": "string"
          },
          "quantity": {
            "default": 1,
            "type": "integer"
          }
        },
        "required": [
          "product_name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "table_identifier": {
      "type": "string"
    }
  },
  "required": [
    "table_identifier",
    "items"
  ],
  "type": "object"
}
Tier 2: 2-Phase Commit Supervisor PIN pos_live pos:write

pos_order_mutate_2pc

Prepara mutaciones críticas de comanda (enviar a cocina o anular platillo con PIN) emitiendo preview_token 2PC.

{
  "properties": {
    "action": {
      "enum": [
        "send_to_kitchen",
        "void_item"
      ],
      "type": "string"
    },
    "item_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reason": {
      "type": "string"
    },
    "table_or_order": {
      "type": "string"
    }
  },
  "required": [
    "table_or_order",
    "action"
  ],
  "type": "object"
}
Tier 0: Read Only pos_live pos:read

pos_pre_shift_briefing

Genera el briefing pre-turno inteligente: reservas VIP de hoy, platillos 86 agotados y sugerencias de venta sugestiva de alto margen.

{
  "properties": {
    "shift": {
      "default": "activo",
      "enum": [
        "comida",
        "cena",
        "activo"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
Tier 1: Undoable pos_live pos:write

pos_table_context_and_open

Resuelve una mesa por su identificador natural ('Mesa 4', '4', 'Terraza 1') y consulta sus consumos o abre la comanda.

{
  "properties": {
    "action": {
      "default": "get_context",
      "enum": [
        "get_context",
        "open"
      ],
      "type": "string"
    },
    "guest_count": {
      "default": 2,
      "type": "integer"
    },
    "table_identifier": {
      "description": "Nombre o n\u00famero de mesa.",
      "type": "string"
    }
  },
  "required": [
    "table_identifier"
  ],
  "type": "object"
}
Tier 1: Undoable booking booking:write

waitlist_walkin_workflow

Gestión de fila de espera presencial (Walk-in): encolar con prioridad VIP automática, cálculo de EWT y reversión rápida.

{
  "properties": {
    "action": {
      "default": "enqueue",
      "enum": [
        "enqueue",
        "seat",
        "cancel"
      ],
      "type": "string"
    },
    "covers": {
      "default": 2,
      "type": "integer"
    },
    "customer_name": {
      "type": "string"
    },
    "customer_phone": {
      "type": "string"
    },
    "table_identifier": {
      "type": "string"
    }
  },
  "required": [
    "action",
    "customer_name",
    "customer_phone"
  ],
  "type": "object"
}

📚 Recursos Pasivos y Slash Prompts

Contexto reactivo adjunto vía URIs estándar (resources) y plantillas operativas de interacción en lenguaje natural (prompts).

1. MCP Resources (4 Plantillas URI)

URI Canónica Nombre del Recurso MIME Type Módulo RBAC
mauricio://{slug}/pulse/live Pulso en Vivo 360° del RestauranteSnapshot en tiempo real: ocupación de mesas, ventas del turno, lista de espera, reservas de hoy y personal activo. application/json pos_overview
mauricio://{slug}/menu/active-compact Menú Activo CompactoCatálogo estructurado optimizado para tokens con platillos, precios, disponibilidad y categorías activas. application/json pos_interface
mauricio://{slug}/booking/policies Políticas de Reservación y HorariosReglas de aforo, anticipos, tolerancia, horarios efectivos y configuraciones de reserva de la sucursal. application/json pos_reservations
mauricio://{slug}/playbooks/llms Playbooks y Guía de Auto-Corrección para AgentesEspecificación de auto-recuperación RFC 7807 y manual operativo de agentes en formato markdown. text/markdown Público Auth

2. MCP Prompts & Slash Commands (7 Comandos)

Slash Command Título Operativo Dominio Argumentos Clave
/pulso Diagnóstico Ejecutivo 360° en VivoObtiene un resumen en tiempo real del piso, mesas ocupadas, ventas del turno, reservas, fila de espera y personal activo. pos_live Sin argumentos
/86 Cascada Omnicanal 86 (Agotar / Reactivar Platillo)Marca un platillo como agotado o disponible en POS y Foodtech, audita impacto en comandas abiertas y sugiere sustitutos. pos_catalog product_name* action reason
/comanda Captura Rápida de Comanda de MesaLevanta o complementa la comanda de una mesa mediante lenguaje natural con resolución tolerante y confirmación 2PC. pos_live table_number* items_text* notes
/reservar Concierge Inteligente de ReservacionesVerifica disponibilidad en tiempo real, registra comensales con cruce CRM y crea o reagenda reservaciones. booking customer_name* phone* date* time* covers* notes
/reservas Reservaciones y Capacidad del DíaConsulta comensales esperados, reservaciones confirmadas y ocupación proyectada de hoy. pos_live filter
/briefing-turno Pre-Shift VIP & Margin BriefingGenera el briefing para el pase de turno: clientes VIP esperados, platillos de alto margen a empujar y alertas operativas. pos_live shift
/auditar-cierre Auditor Forense de Pre-Cierre de TurnoInspecciona cuentas abiertas, mesas fantasma, comandas no impresas y discrepancias antes de permitir el corte de caja. pos_live terminal_id
/portal Diagnóstico 360° de Portal FoodTechAudita el estado del sitio web gastronómico, menús publicados, dominio y reservaciones online. foodtech Sin argumentos
/proactivo Monitoreo Proactivo de Cuellos de BotellaEvalúa mesas con comandas estancadas, retrasos en cocina y tiempos de espera de comensales. pos_live Sin argumentos
/evento Publicación Asistida de Cartelera FoodTechRedacta, estructura y prepara la publicación de un evento o experiencia gastronómica en el sitio web con vista previa 2PC. foodtech title* date* description price

🧪 MCP Inspector & Playground Sandbox

Inspecciona y prueba llamadas JSON-RPC 2.0 al endpoint POST /api/v1/mcp. Puedes probar en modo simulación (sin API Key) o en modo Live BYOK con tu clave real.

⚡ Streamable HTTP Inspector

Listo