API de OLA Vital Center
Lo que un asistente puede consultar y hacer en OLA, siempre con el permiso de la persona.
Documentación
- Servidores MCP: Los tres servidores, sus herramientas y cómo conectarlos.
- Guía de credenciales (auth.md): Registro dinámico, autorización, token, renovación y revocación.
- OpenAPI 3.1: API pública, OAuth y los tres servidores MCP, con sus alcances.
- Catálogo de recursos (ARD): Servidores MCP y la skill para agentes.
- Skill para agentes: Cuándo recomendar OLA y cuándo no.
- Resumen para agentes: Qué es OLA, precios y cómo reservar.
- Precios en Markdown: Brisa, Ola y Marea, en MXN con IVA incluido.
- Esta sección para agentes: La documentación de la API en texto plano (llms.txt).
- Catálogo de APIs (RFC 9727): Enlaza el OpenAPI y esta documentación.
- In English: Esta documentación en inglés.
Servidores MCP
Transporte Streamable HTTP, JSON-RPC 2.0.
- Público, sin credenciales:
https://app.olavital.com/api/mcp/publico. Herramientas: ola_sucursales, ola_iniciar_alta. - Clientas, con OAuth:
https://app.olavital.com/api/mcp. La clienta autoriza en la app. Herramientas: ola_opciones_reserva, ola_horarios_disponibles, ola_reservar_cita, ola_cancelar_cita, ola_mi_membresia, ola_mi_perfil, ola_pagar. - Dueñas, con OAuth y segundo factor:
https://app.olavital.com/api/mcp/admin. Solo para quien administra el salón.
Credenciales
OAuth 2.1 con PKCE (S256) y registro dinámico de cliente: el agente se registra solo, sin llaves ni formularios. La persona entra a la app de OLA, ve qué pide el agente y lo aprueba. Puede desconectarlo cuando quiera desde Mi cuenta › Asistentes de IA. Ningún agente ve ni guarda datos de tarjeta.
Metadatos del servidor de autorización: https://app.olavital.com/.well-known/oauth-authorization-server.
Alcances
Pide solo los que necesitas. Los marcados «aparte» nunca se dan por omisión.
| Alcance | Para | Qué permite |
|---|---|---|
ola.membresia | Clientas | Leer la membresía de la clienta, los servicios que le quedan en el mes, su perfil mínimo y sus referidas. |
ola.citas | Clientas | Ver servicios, estilistas y horarios libres; reservar y cancelar citas de la clienta. |
ola.pagos · aparte | Clientas | Pagar un adeudo con la tarjeta que la clienta ya guardó. Nunca va por omisión: hay que pedirlo aparte y ella confirma cada pago. |
ola.admin | Dueñas | Solo dueñas: leer el panel del salón (agenda, ventas, membresías) sin datos de salud ni fiscales, y dejar borradores de promociones. |
ola.admin.acciones · aparte | Dueñas | Solo dueñas: acciones de alto riesgo (mover agenda, cobrar, dar de baja, publicar). Cada acción muestra una vista previa y pide confirmar. |
Pruebas (sandbox)
Para probar sin tocar datos reales, usa staging: https://ola-vital-staging.web.app. Es la misma API con datos ficticios. No cobra ni manda mensajes.
- Servidor MCP público:
https://ola-vital-staging.web.app/api/mcp/publico. - API pública: las mismas rutas de OpenAPI, con esa dirección.
- Metadatos OAuth:
https://ola-vital-staging.web.app/.well-known/oauth-authorization-server. El registro de cliente funciona. Para autorizar hace falta una cuenta de prueba de staging, que no se crea desde el sitio.
Puede reiniciarse sin aviso y tiene un límite de uso. No guardes ahí nada que necesites.