API REST

La API pública

El propio sitio funciona con esta API: JSON sobre HTTPS en /api/v1, descrita por un documento OpenAPI 3.1 generado a partir del código. La página de documentación muestra cada endpoint y permite probarlo.

Para asistentes de IA

El servidor MCP

Asistentes como Claude pueden consultar la disponibilidad y reservar, ver, cambiar o cancelar una mesa para un comensal mediante el Model Context Protocol. El servidor es un cliente de la misma API pública, así que toda regla del sitio se aplica también a un asistente.

Endpoint
/mcp
Transporte
HTTP en streaming (Streamable HTTP)
Autenticación
Un token bearer emitido por el restaurante

Herramientas

get_restaurant_info
Dirección, horario, contacto, reglas de reserva y premios.
get_menu
El menú en inglés, italiano, español o francés, con precios, calorías, alérgenos y advertencias.
check_availability
Los horarios libres de una fecha, con el número de mesas disponibles.
book_table
Reserva una mesa y devuelve el código de confirmación; se puede reintentar sin riesgo.
lookup_reservation
Muestra una reserva a partir de su código y del correo con el que se hizo.
modify_reservation
Cambia la hora o el número de comensales.
cancel_reservation
Cancela una reserva (el asistente pide antes la confirmación del comensal).
subscribe_newsletter
Suscribe a un comensal a la carta de temporada.

Ambos funcionan con el mismo restaurante ficticio que este sitio: las reservas son solo de demostración.

Versiones

Qué está en marcha

Sitio web
6.0.2 · 00237aa
API
comprobando…
Servidor MCP
comprobando…
Esquema de la base de datos
comprobando…