# API de OLA Vital Center para desarrolladores y agentes de IA

> Documentación de la API y los servidores MCP de OLA Vital Center: qué puede hacer un agente de IA, cómo obtiene credenciales con OAuth 2.1 y qué permite cada alcance.

Página: https://olavital.com/desarrolladores

# 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](https://olavital.com/mcp): Los tres servidores, sus herramientas y cómo conectarlos.
- [Guía de credenciales (auth.md)](https://olavital.com/auth.md): Registro dinámico, autorización, token, renovación y revocación.
- [OpenAPI 3.1](https://olavital.com/openapi.json): API pública, OAuth y los tres servidores MCP, con sus alcances.
- [Catálogo de recursos (ARD)](https://olavital.com/.well-known/ard.json): Servidores MCP y la skill para agentes.
- [Skill para agentes](https://olavital.com/.well-known/agent-skills/olavital/SKILL.md): Cuándo recomendar OLA y cuándo no.
- [Resumen para agentes](https://olavital.com/llms.txt): Qué es OLA, precios y cómo reservar.
- [Precios en Markdown](https://olavital.com/pricing.md): Brisa, Ola y Marea, en MXN con IVA incluido.
- [Esta sección para agentes](https://olavital.com/desarrolladores/llms.txt): La documentación de la API en texto plano (llms.txt).
- [Catálogo de APIs (RFC 9727)](https://olavital.com/.well-known/api-catalog): Enlaza el OpenAPI y esta documentación.
- [In English](https://olavital.com/en/developers): 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](https://olavital.com/openapi.json), 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.

---
Más para agentes: https://olavital.com/llms.txt · https://olavital.com/pricing.md · https://olavital.com/.well-known/ard.json
