Cuando alguien le pregunta a una IA dónde aprender a surfear, devolvemos clases de verdad — playa, nivel, hora, precio — listas para reservar. No un artículo. Clases reales, de escuelas certificadas.
{
"spot": "Ribeira d'Ilhas",
"date": "2026-06-13",
"time": "09:00",
"level": "iniciante",
"price": "€45",
"book": "surfbooking.eu/reservar/…"
}La víspera de llegar a Portugal, un turista le pregunta a una IA: "¿dónde aprendo a surfear este fin de semana?"
Hoy, el asistente todavía responde con un mapa genérico. Pero SurfBooking ya ha construido el puente: un índice para LLMs y un endpoint MCP que devuelven clases reales — la playa adecuada para el nivel, a horas que existen de verdad, con el enlace para reservar. A medida que los asistentes abren los conectores, SurfBooking pasa a ser la respuesta. Y quien ya conecta hoy — por conector o MCP — las recibe desde ya.
El LLM no lee una página: pide una de estas cosas y recibe datos verdaderos al momento, incluido el estado del mar en cada playa.
Por playa, zona, nivel, fecha o precio máximo. Devuelve clases reservables con día, hora, playa, escuela, precio y enlace.
Precio, duración, plazas y qué incluye: traje, tabla, transporte, seguro.
El enlace seguro donde el surfista reserva y paga. El agente nunca cobra.
Una nota de 0 a 10 ajustada al nivel, con ola, periodo y viento, y la mejor ventana de cada día. Responde a: ¿qué día debo reservar?
Las playas activas por orden de las condiciones en directo, con ola, viento, nota y enlace.
La misma ola es buena para un principiante y floja para un avanzado. Esta ordena por lo bien que cada playa sirve al nivel pedido.
Clases reservables solo en las playas donde el mar cumple de verdad el mínimo pedido de ola, nota o viento flojo.
Cada zona con cuántas escuelas tiene y si hay clases para reservar. El primer paso de un: ¿dónde aprendo a surfear?
Playas por zona, con tipo de fondo y una descripción corta, para separar las buenas para principiantes de las demás.
Traje, tabla, invento y escarpines a partir del peso, la altura y el nivel. Tallas europeas, sin promover ninguna marca.
Los hoteles asociados de SurfBooking, por zona o ciudad.
Todas solo leen. Ninguna crea, cancela, cambia precios ni horarios, ni devuelve datos de alumnos.
Esto no es una maqueta — es lo que devuelve nuestro endpoint MCP, ahora. Cualquier agente conectado al MCP recibe exactamente esto. (No es lo que hace una IA por su cuenta hoy — es lo que recibe cuando la conectas.)
▸ usuario: "Resérvame una clase de surf para principiantes en Portugal este fin de semana." # el agente llama a search_lessons("principiante") y SurfBooking devuelve: - 13 jun · 09:00 · Ribeira d'Ilhas · principiante · €45 → reservar: surfbooking.eu/reservar/... - 14 jun · 09:00 · Ribeira d'Ilhas · principiante · €45 → reservar: surfbooking.eu/reservar/... # la reserva se completa de forma segura. El pago lo confirma la persona.
En Claude.ai (Pro), añades SurfBooking como conector personalizado en 20 segundos. Sin instalar nada, sin clave.
https://www.surfbooking.eu/api/mcpEn Claude.ai: Ajustes → Conectores (o Personalizar → Conectores).
Haz clic en "Añadir conector personalizado".
Nombre: SurfBooking. En el campo "URL del servidor MCP remoto", pega la dirección de arriba. Deja el OAuth en blanco — es público, sin clave.
Haz clic en Añadir. Después pregunta "clases de surf para principiantes este fin de semana" — y recibes clases reales, listas para reservar.
El mismo URL funciona en cualquier cliente compatible con MCP, a medida que se van abriendo los conectores. Para el terminal o Claude Desktop, mira abajo.
Sin instalar nada. Pega en el terminal:
# buscar una clase de principiante curl -s https://www.surfbooking.eu/api/mcp \ -H "content-type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"search_lessons", "arguments":{"query":"iniciante ericeira"}}}'
En un cliente con soporte MCP: en Claude.ai (Pro) añades el URL como conector; en Claude Desktop conectas vía mcp-remote:
{
"mcpServers": {
"surfbooking": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
}
}
}En los grandes asistentes de IA, el soporte para conectores MCP está abriéndose ahora. Pero la forma que ya funciona hoy es la más simple: cuando cualquier asistente navega por la web, lee nuestro índice para LLMs y recomienda clases reales de SurfBooking — sin conectar nada.
Los socios oficiales de SurfBooking (hoteles, marcas de equipamiento) reciben una clave con scope que limita el MCP a sus propios datos — para que una integración de hotel nunca muestre una marca de tabla de la competencia, y una marca de equipamiento nunca anuncie una cadena hotelera ajena.
find_hotels devuelve solo las propiedades del socio. size_equipment da un sizing neutro — no se promociona ninguna marca de equipamiento.
size_equipment recomienda el catálogo propio de la marca. find_hotels queda oculto — no forma parte de esta integración.
¿Quieres una clave con scope para tu marca? Envía un email a [email protected] — verificamos la asociación y configuramos el scope.
Una puerta separada de la pública, solo para tu escuela. El asistente lee lo que tu rol ya ve en SurfBooking OS y puede preparar dos cambios, que solo ocurren cuando el propietario los confirma en el OS.
Estado hoy: está desactivado por defecto y aún no se ha validado con un asistente real. Mientras esté desactivado, la dirección responde 404.
Quien crea la clave es el propietario, en SurfBooking OS, en la ventana «Assistentes ligados»: allí la revoca, ve las peticiones del asistente y confirma las propuestas.
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…El nombre de la escuela, tu rol, los permisos de la clave y cuándo caduca.
Las clases entre dos fechas, hasta 14 días: hora, playa, nivel, instructores y plazas libres. Un instructor solo ve las suyas.
Recuentos por día, hasta 31 días: confirmadas, check-in, ausencias y participantes. Sin importes de dinero. Propietario, o equipo con acceso a informes.
Solo el nombre de pila, el check-in y las tallas ya registradas. Sin contactos, salud, alergias ni fechas de nacimiento.
El material por categoría y talla: cantidad, en reparación y disponible.
Para las clases de los próximos días, hasta 7: nota, ola, periodo, viento y un aviso de riesgo para el nivel de la clase.
Crea una propuesta pendiente de nueva fecha y hora. La clase no cambia. Las clases que ya tienen alumnos no se aceptan en esta versión.
Crea una propuesta pendiente para fijar, sumar o quitar unidades, hasta 30 líneas. El stock no cambia y nunca baja de cero.
Las propuestas preparadas y el estado de cada una. El propietario ve todas; el equipo ve las suyas.
No toca el dinero: pagos, reembolsos, precios ni cancelaciones. No aplica nada por sí solo: cada cambio espera la confirmación del propietario en el OS, que pasa por las mismas validaciones del panel.
La clave se genera con la sesión del propietario en SurfBooking OS y se muestra una sola vez. Solo guardamos su resumen, dura 30, 90 o 365 días y se revoca cuando quieras. La pantalla en Ajustes llega en la próxima fase.
En Claude Desktop se conecta mediante mcp-remote, con la clave en una cabecera:
{
"mcpServers": {
"surfbooking-escola": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp/escola",
"--header", "Authorization:${SB_SCHOOL_AUTH}"],
"env": { "SB_SCHOOL_AUTH": "Bearer sbek_XXXXXXXXXX_…" }
}
}
}El conector personalizado de Claude.ai en la web y el de ChatGPT no permiten enviar una clave en una cabecera, solo OAuth, que este conector aún no tiene. Hoy solo funciona en clientes que envían la cabecera. Ningún cliente se ha validado en vivo.
Abrimos la puerta a las IA del mundo — pero con reglas que están en el código, no en la confianza.
Siempre devuelve un enlace; el surfista confirma y paga en SurfBooking. Ningún agente toca tu dinero.
El LLM solo puede leer. No crea, no cancela, no cambia precios ni horarios. Lo máximo que hace es buscar clases.
Solo sale información pública de la clase. Los nombres, emails y teléfonos de los alumnos nunca salen de SurfBooking.
Aguanta miles de peticiones sin afectar al servicio de las escuelas — y se cierra en un instante si hace falta.
Clases reales, de escuelas certificadas, listas para reservar.
Reservar una clase