Beach ValenciaLuxury

Servidor MCP para agentes de IA

Última actualización: 30 de septiembre de 2026

Beach Valencia publica un servidor Model Context Protocol (MCP) de solo lectura para que asistentes y agentes de IA — Claude, ChatGPT y cualquier otro cliente compatible — puedan consultar disponibilidad, precios y políticas de nuestros apartamentos en tiempo real y llevar al viajero a la web para completar la reserva.

URL del servidor

Streamable HTTP en modo stateless. Cualquier cliente MCP compatible puede añadirlo con la URL:

https://www.beachvalencia.com/api/mcp

Herramientas disponibles

Las cuatro herramientas son de solo lectura (readOnlyHint: true). Ninguna modifica datos, cobra ni reserva.

  • search_availability — busca disponibilidad para unas fechas y número de personas en todas las categorías.
  • get_property_details — descripción, capacidad, fotos y ubicación genérica de una categoría (G1..G6, G4B).
  • get_quote — cotización exacta para una categoría concreta, con fianza y política de cancelación.
  • get_policies — check-in/out, cancelación, fianza, registro de viajeros (SES.Hospedajes) y contacto.

Ejemplos de prompt

  • «Búscame un apartamento de dos habitaciones cerca de la playa en Valencia para cuatro personas, del 15 al 20 de octubre, por menos de 900 €.»
  • «¿Cuánto cuesta exactamente el apartamento más grande con piscina del 24 de diciembre al 1 de enero para seis personas?»
  • «¿Cuál es la política de cancelación si reservo ahora y cancelo una semana antes de la llegada?»

Qué NO hace

  • No cobra ni reserva desde el chat: cualquier reserva y pago se completan en beachvalencia.com con el mismo checkout que una reserva directa.
  • No expone códigos de apartamento (Axxx-N) ni direcciones exactas. La dirección concreta y las instrucciones de acceso se envían por email cuando la reserva está confirmada.
  • No valida ni aplica códigos de descuento. Si tienes uno, lo introduces tú mismo en el checkout de la web.
  • No accede a datos personales del huésped ni al historial de reservas.
  • Los precios que devuelve son la tarifa pública para no-miembro sin código: el mismo importe que verías al pagar en la web.

Datos que registramos

Cada llamada al servidor MCP se registra de forma anónima con la única finalidad de operar, dimensionar el servicio y detectar abuso: fecha y hora, herramienta invocada, parámetros de la consulta (fechas, número de personas, categoría), latencia, resultado y — si el cliente MCP la envía — la identificación del propio cliente (por ejemplo, «claude.ai» o «chatgpt.com»). No guardamos tu dirección IP en claro: se convierte en un hash irreversible (SHA-256 sobre IP + user-agent + un secreto interno) que solo sirve para limitar el ritmo de peticiones por sesión.

Límites y kill-switch

  • Hasta 600 llamadas cada 10 minutos por sesión anónima (ip_hash).
  • Tope global upstream a nuestro gestor: 120 llamadas por minuto.
  • Los picos por encima del límite devuelven un error legible con retry_after_seconds; no se reintenta agresivamente.
  • Kill-switch operativo (MCP_ENABLED=false) devuelve HTTP 503 con un mensaje legible sin llegar a llamar al gestor.

Registro público

Estamos publicados en el registro oficial del Model Context Protocol con el nombre canónico com.beachvalencia/booking. La verificación del espacio de nombres se realiza mediante DNS (Ed25519).

  • Listing: https://registry.modelcontextprotocol.io/v0/servers?search=com.beachvalencia/booking

Legales y contacto

El uso del servidor está sujeto a nuestra Política de Privacidad y a los Términos y condiciones de alquiler.

  • Privacidad: https://www.beachvalencia.com/privacidad
  • Términos y condiciones: https://www.beachvalencia.com/legal/condiciones
  • Contacto operativo (bugs, cortes, feedback): reservas@beachvalencia.com