API y servidor MCP

Conectar un asistente

Añade https://maitreai.es/api/mcp como servidor MCP remoto en Claude, ChatGPT o cualquier cliente que hable el protocolo, y pídele que busque un negocio y consulte huecos. No hace falta clave: el endpoint es público y está limitado por IP, igual que la página de reservas que refleja.

Es transporte Streamable HTTP sobre POST, con respuesta JSON: no abre un stream SSE. El servidor se identifica como maitre y expone herramientas y nada más — sin recursos, sin prompts, sin sampling. La ficha completa, legible por máquina, está en /.well-known/mcp/server-card.json.

Las herramientas

Se usan en cadena, y el orden importa: nunca confirmes una hora que no hayas comprobado con check_availability.

1. 1

   search_businesses — Buscar negocios

   Busca restaurantes, peluquerías, barberías, clínicas y otros negocios locales que aceptan reservas. Devuelve el slug de cada uno, que hace falta para el resto de herramientas.

2. 2

   get_business — Ver un negocio

   Devuelve horario, servicios con precio y duración, profesionales y condiciones de un negocio. Úsalo antes de reservar para saber qué servicios existen.

3. 3

   check_availability — Consultar huecos

   Devuelve las horas realmente libres de un día. Úsalo siempre antes de crear una reserva: no supongas que hay hueco.

4. 4

   create_reservation — Reservar

   Crea una reserva. Comprueba antes la disponibilidad con check_availability y pide al cliente su nombre y teléfono. La reserva queda pendiente de que el negocio la confirme.

Qué pasa tras reservar

La reserva entra como pending y queda pendiente de que el negocio la confirme. No le digas a nadie que su hora está garantizada: todavía no lo está. Si el negocio pide garantía de pago, la herramienta no crea la reserva y devuelve un aviso para terminarla en la web.

Endpoints HTTP

Para integrar máquina a máquina. La especificación completa está en /openapi.json (OpenAPI 3.1). Trabajan con el identificador del negocio; si lo que quieres es conversar, el servidor MCP es mejor camino porque busca por nombre.

Pasado el límite la respuesta es un 429. No es un bloqueo: espera al minuto siguiente. Si reservas en nombre de otra persona, envía source: "assistant" — sin ese valor la reserva cuenta como web y el negocio no sabe de dónde vino.