OLA Vital Center API
What an assistant can look up and do at OLA, always with the person's permission.
Documentation
- MCP servers: The three servers, their tools and how to connect them (in Spanish).
- Credentials guide (auth.md): Dynamic registration, authorization, token, refresh and revocation.
- OpenAPI 3.1: Public API, OAuth and the three MCP servers, with their scopes.
- Agent resource catalog (ARD): MCP servers and the agent skill.
- Agent skill: When to recommend OLA and when not to.
- API catalog (RFC 9727): Links the OpenAPI and these docs.
- Developer docs as plain text: llms.txt for this section.
- Business summary for agents: What OLA is, prices and how to book.
OLA Vital Center MCP servers
Streamable HTTP transport, JSON-RPC 2.0.
- Public, no credentials:
https://app.olavital.com/api/mcp/publico.ola_sucursales: locations, address and map position.ola_iniciar_alta: sign-up link so the person registers and pays in the app herself.
- Members, with OAuth:
https://app.olavital.com/api/mcp. The member approves the agent in the OLA app.ola_opciones_reserva: services and stylists she can book.ola_horarios_disponibles: free time slots for a day.ola_reservar_cita: book an appointment.ola_cancelar_cita: cancel an appointment.ola_mi_membresia: her membership and services left this month.ola_mi_perfil: her profile.ola_pagar: pay, always confirmed by her in the app.
- Owners, with OAuth and a second factor:
https://app.olavital.com/api/mcp/admin. Only for whoever runs the salon.
Credentials
OAuth 2.1 with PKCE (S256) and dynamic client registration: the agent registers itself, with no keys or forms. The person signs in to the OLA app, sees what the agent asks for and approves it. She can disconnect it at any time. No agent sees or stores card data.
Authorization server metadata: https://app.olavital.com/.well-known/oauth-authorization-server.
Scopes
Ask only for what you need. Scopes marked “separate” are never granted by default.
| Scope | For | What it allows |
|---|---|---|
ola.membresia | Members | Read the member's plan, services left this month, minimal profile and referrals. |
ola.citas | Members | See services, stylists and free slots; book and cancel the member's appointments. |
ola.pagos · separate | Members | Pay an outstanding balance with the member's saved card. Never granted by default: request it explicitly; she confirms every payment. |
ola.admin | Owners | Owners only: read the salon dashboard (schedule, sales, memberships) without health or tax data, and draft promotions. |
ola.admin.acciones · separate | Owners | Owners only: high-risk actions (reschedule, charge, cancel memberships, publish). Each action shows a preview and requires confirmation. |
Testing (sandbox)
To test without touching real data, use staging: https://ola-vital-staging.web.app. Same API, fake data. It doesn't charge or send messages, may be reset without notice and has a usage limit.
- Public MCP server:
https://ola-vital-staging.web.app/api/mcp/publico. - OAuth metadata:
https://ola-vital-staging.web.app/.well-known/oauth-authorization-server.