> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brelio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Brelio

> Conecta tu asistente de IA o tu propio software a Brelio, el software de gestión para clínicas sanitarias.

Brelio ofrece a los programas dos puertas a los datos de una clínica. Las dos salen del mismo catálogo de operaciones: cada operación tiene el mismo nombre, las mismas reglas, los mismos permisos y los mismos errores en ambas.

| | API REST | Servidor MCP |
| - | - | - |
| Dirección | `https://api.brelio.app/v1` | `https://api.brelio.app/mcp` |
| Quién llama | Tu código: scripts, integraciones, software de partners | Un asistente de IA: Claude, ChatGPT, Cursor, VS Code, Codex, Gemini |
| Credencial | Una clave de API o el token de una app de partner | Tu cuenta de Brelio, con OAuth; sin clave |
| Actúa como | La clínica (clave de la organización, app de partner) o una persona (clave personal) | La persona que lo conectó |
| Qué puede hacer hoy | Leer y escribir: reservar, reprogramar y cancelar citas, gestionar pacientes y webhooks | Solo leer; las escrituras van por REST. Consulta las [limitaciones conocidas](https://docs.brelio.com/es/changelog.md#limitaciones-conocidas) |

> [card] [Conecta tu asistente de IA](https://docs.brelio.com/es/quickstart/mcp.md)
>
> Dos minutos: añade el servidor MCP a tu asistente, inicia sesión y pregunta por tu clínica.

> [card] [Haz tu primera llamada a la API](https://docs.brelio.com/es/quickstart/api.md)
>
> Dos minutos: crea una clave de API y lista los servicios de tu clínica con `curl`.

## Qué puedes construir

* **Un asistente para recepción.** Pregunta «¿Qué huecos tiene Laia el jueves por la mañana?» y obtén huecos libres reales de la agenda.
* **Reserva online.** Busca huecos libres, reserva al paciente y reprograma o cancela cuando lo pida.
* **Sincronización con tus sistemas.** Mantén un CRM, una centralita o un almacén de datos al día con los pacientes y las citas de la clínica.
* **Automatizaciones.** Conecta Brelio con n8n, Make o tus propios scripts y recibe webhooks firmados en lugar de consultar cada poco.

## Lo que siempre se cumple

* **Las mismas reglas que la web.** Los mismos permisos, la misma visibilidad de centros, la misma validación y los mismos límites del plan.
* **Los datos de pacientes están cerrados por defecto.** La clínica decide qué [áreas de datos](https://docs.brelio.com/es/concepts/data-areas.md) pueden usar las integraciones, y cada credencial necesita su propia aceptación antes de tocar datos de pacientes.
* **Los cambios nunca se pisan.** Cada registro lleva una `version`, que devuelves como `expectedVersion` ([concurrencia](https://docs.brelio.com/es/concepts/concurrency.md)).
* **Reintentar es seguro.** Cada escritura lleva una `Idempotency-Key` ([idempotencia](https://docs.brelio.com/es/concepts/idempotency.md)).
* **Los errores se explican solos.** Un único formato JSON con un `code` estable y, cuando lo hay, un `hint` ([errores](https://docs.brelio.com/es/concepts/errors.md)).
* **Todo queda registrado.** La clínica ve cada conexión y lo que hizo, también los intentos rechazados.

> [!NOTE]
>
> La API y el servidor MCP están en acceso anticipado. Una organización sin acceso recibe `402 PLATFORM_PLAN_REQUIRED`. La API, sus textos de error y el documento OpenAPI están en inglés; esta documentación está en español y en inglés.

## Recursos para máquinas

| Recurso | Dirección |
| - | - |
| Documento OpenAPI 3.1 | `https://api.brelio.app/v1/openapi.json` |
| Servidor MCP | `https://api.brelio.app/mcp` |
| Metadatos OAuth del recurso protegido | `https://api.brelio.app/.well-known/oauth-protected-resource/mcp` |
| Esta documentación en texto plano, para LLM | `https://docs.brelio.com/llms.txt` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.