Trovare lezioni e vedere il mare
Senza account. Chiedi dove imparare, quale lezione va bene per il tuo livello e com'è il mare a quell'ora. Per prenotare ricevi il link e paghi su SurfBooking.
Prenotabile dagli LLM
Quando qualcuno chiede a una IA dove imparare a surfare, restituiamo lezioni vere — spiaggia, livello, ora, prezzo — pronte da prenotare. Non un articolo. Lezioni reali, di scuole.
MCP live · qualsiasi assistente compatibile si connette e riceve lezioni reali
Esempio illustrativo · non sono dati in diretta
{
"spot": "Ribeira d'Ilhas",
"date": "2026-06-13",
"time": "09:00",
"level": "iniciante",
"price": "€45",
"book": "surfbooking.eu/reservar/…"
}Il momento
La sera prima di arrivare in Portogallo, un turista chiede a una IA: "dove imparo a surfare questo weekend?"
Oggi l'assistente risponde ancora con una mappa generica. Ma SurfBooking ha già costruito il ponte: un indice per LLM e un endpoint MCP che restituiscono lezioni reali — la spiaggia giusta per il livello, a orari che esistono davvero, con il link per prenotare. Man mano che gli assistenti aprono i connettori, SurfBooking diventa la risposta. E chi si collega già oggi — via connettore o MCP — le riceve subito.
Un connettore per ogni ruolo
Senza account. Chiedi dove imparare, quale lezione va bene per il tuo livello e com'è il mare a quell'ora. Per prenotare ricevi il link e paghi su SurfBooking.
Il titolare entra con l'account della scuola. Legge lezioni, prenotazioni, attrezzatura e mare, e prepara modifiche che avvengono solo quando le confermi nell'OS. Non tocca mai il denaro.
Ogni istruttore entra con il proprio account. Vede solo le lezioni che tiene, gli orari, chi viene e il mare per quelle lezioni. Non cambia nulla e smette di funzionare se lascia la scuola.
Cosa può fare l'LLM
L’LLM non legge una pagina: chiede una di queste cose e riceve dati veri sul momento, compreso lo stato del mare in ogni spiaggia.
Per spiaggia, zona, livello, data o prezzo massimo. Restituisce lezioni prenotabili con giorno, ora, spiaggia, scuola, prezzo e link.
Prezzo, durata, posti e cosa include: muta, tavola, trasporto, assicurazione.
Il link sicuro dove il surfista prenota e paga. L’agente non incassa mai.
Un voto da 0 a 10 tarato sul livello, con onda, periodo e vento, e la finestra migliore di ogni giorno. Risponde a: che giorno devo prenotare?
Le spiagge attive ordinate per condizioni dal vivo, con onda, vento, voto e link.
La stessa onda è buona per un principiante e debole per un avanzato. Questa ordina per quanto ogni spiaggia serve al livello chiesto.
Lezioni prenotabili solo nelle spiagge dove il mare raggiunge davvero il minimo chiesto di onda, voto o vento debole.
Ogni zona con quante scuole ha e se ci sono lezioni da prenotare. Il primo passo di un: dove imparo a surfare?
Spiagge per zona, con tipo di fondo e una breve descrizione, per distinguere quelle buone per principianti dalle altre.
Muta, tavola, leash e scarpette da peso, altezza e livello. Taglie europee, senza promuovere nessun marchio.
Gli hotel partner di SurfBooking, per zona o città.
Tutti leggono soltanto. Nessuno crea, annulla, cambia prezzi o orari, né restituisce dati di allievi.
Esempio illustrativo
Esempio illustrativo, con date e link di esempio. Non mostra la disponibilità attuale. Usa la query qui sotto per cercare lezioni disponibili.
▸ utente: "Prenotami una lezione di surf per principianti in Portogallo questo weekend." # l'agente chiama search_lessons("principiante") e SurfBooking restituisce: - 13 giu · 09:00 · Ribeira d'Ilhas · principiante · €45 → prenotare: surfbooking.eu/reservar/... - 14 giu · 09:00 · Ribeira d'Ilhas · principiante · €45 → prenotare: surfbooking.eu/reservar/... # la prenotazione si conclude in sicurezza. Il pagamento è confermato dalla persona.
Collega a Claude.ai
Su Claude.ai (Pro) aggiungi SurfBooking come connettore personalizzato in 20 secondi. Niente da installare, nessuna chiave.
https://www.surfbooking.eu/api/mcpSu Claude.ai: Impostazioni → Connettori (o Personalizza → Connettori).
Clicca su "Aggiungi connettore personalizzato".
Nome: SurfBooking. Nel campo "URL del server MCP remoto", incolla l'indirizzo qui sopra. Lascia OAuth vuoto — è pubblico, senza chiave.
Clicca su Aggiungi. Poi chiedi "lezioni di surf per principianti questo weekend" — e ricevi lezioni reali, pronte da prenotare.
Lo stesso URL funziona in qualsiasi client compatibile con MCP, man mano che si aprono i connettori. Per il terminale o Claude Desktop, guarda qui sotto.
Prova
Senza installare nulla. Incolla nel terminale:
# cercare una lezione per principianti 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"}}}'
In un client con supporto MCP: su Claude.ai (Pro) aggiungi l'URL come connettore; su Claude Desktop ti colleghi via mcp-remote:
{
"mcpServers": {
"surfbooking": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
}
}
}Nei grandi assistenti di IA il supporto per i connettori MCP si sta aprendo adesso. Ma il modo che funziona già oggi è il più semplice: quando un assistente naviga sul web, legge il nostro indice per LLM e consiglia lezioni reali di SurfBooking — senza collegare niente.
Integrazioni partner
I partner ufficiali di SurfBooking (hotel, marchi di attrezzatura) ricevono una chiave con scope che limita l'MCP ai loro dati — così un'integrazione di hotel non mostra mai un marchio di tavole concorrente, e un marchio di attrezzatura non pubblicizza mai una catena alberghiera altrui.
find_hotels restituisce solo le strutture del partner. size_equipment dà un sizing neutro — nessun marchio di attrezzatura viene promosso.
size_equipment consiglia il catalogo proprio del marchio. find_hotels resta nascosto — non fa parte di questa integrazione.
Vuoi una chiave con scope per la tua marca? Manda un'email a [email protected] — verifichiamo la partnership e configuriamo lo scope.
Per le scuole
Una porta separata da quella pubblica, solo per la tua scuola. L’assistente legge ciò che il tuo ruolo vede già in SurfBooking OS e può preparare due modifiche, che avvengono solo quando il titolare le conferma nell’OS.
Stato oggi: è disattivato per impostazione predefinita e non è ancora stato validato con un assistente reale. Finché è disattivato, l’indirizzo risponde 404.
La chiave la crea il titolare, in SurfBooking OS, nella finestra «Assistentes ligados»: lì la revoca, vede le richieste dell'assistente e conferma le proposte.
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…Il nome della scuola, il tuo ruolo, i permessi della chiave e quando scade.
Oggi e i prossimi giorni, fino a 7, in ora di Lisbona: lezioni, persone e posti liberi, e cosa richiede attenzione (mare al limite per il livello, lezione senza istruttore, nessuno prenotato nelle prossime 48 ore, attrezzatura esaurita, proposte in attesa).
Le lezioni tra due date, fino a 14 giorni: ora, spiaggia, livello, istruttori e posti liberi. Un istruttore vede solo le sue.
Conteggi per giorno, fino a 31 giorni: confermate, check-in, assenze e partecipanti. Nessun importo in denaro. Titolare, o staff con accesso ai report.
Solo il nome, il check-in e le taglie già registrate. Nessun contatto, salute, allergia o data di nascita.
L’attrezzatura per categoria e taglia: quantità, in riparazione e disponibile.
Per le lezioni dei prossimi giorni, fino a 7: voto, onda, periodo, vento e un avviso di rischio per il livello della lezione.
Con i limiti del mare della tua scuola per livello: per ogni lezione con il mare fuori dal suo livello, la finestra migliore e cosa fare (spostare, proporre agli allievi o solo avvisare). Non cambia nulla; spostare richiede la tua conferma nell'OS.
Crea una proposta in sospeso con nuova data e ora. La lezione non cambia. Le lezioni che hanno già allievi non sono accettate in questa versione.
Crea una proposta in sospeso per impostare, aggiungere o togliere unità, fino a 30 righe. Lo stock non cambia e non scende mai sotto zero.
Le proposte preparate e lo stato di ciascuna. Il titolare le vede tutte; lo staff vede le proprie.
Non tocca il denaro: pagamenti, rimborsi, prezzi o cancellazioni. Non applica nulla da solo: ogni modifica attende la conferma del titolare nell’OS, che passa per gli stessi controlli del pannello.
La chiave si genera con la sessione del titolare in SurfBooking OS e viene mostrata una sola volta. Ne conserviamo solo l’impronta, vale 30, 90 o 365 giorni e si revoca quando vuoi. La schermata nelle Impostazioni arriva nella prossima fase.
Su Claude Desktop ci si collega tramite mcp-remote, con la chiave in un’intestazione:
{
"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_…" }
}
}
}Claude e ChatGPT si collegano con l'accesso: l'assistente apre una pagina di SurfBooking, scegli la scuola e premi Autorizza. La chiave sbek_ in un'intestazione è per i client configurati a mano. Nessun client è stato validato dal vivo.
E la tua sicurezza?
Apriamo la porta alle IA del mondo — ma con regole che vivono nel codice, non nella fiducia.
Restituisce sempre un link; il surfista conferma e paga su SurfBooking. Nessun agente tocca i tuoi soldi.
L'LLM può solo leggere. Non crea, non cancella, non cambia prezzi né orari. Al massimo cerca lezioni.
Esce solo l'informazione pubblica della lezione. Nomi, email e telefoni degli allievi non escono mai da SurfBooking.
Regge migliaia di richieste senza intaccare il servizio alle scuole — e si chiude in un istante se serve.

Pronta per la prossima onda
Lezioni reali, di scuole, pronte da prenotare.
Prenotabile dagli LLM — l'MCP delle prenotazioni di surf. Lezioni reali, di scuole in Portogallo, pronte da prenotare.
Endpoint MCPhttps://www.surfbooking.eu/api/mcp
Prenota una lezionePer le scuoleIndice llms.txtPrivacy
© 2026 SurfBooking · SurfBooking® — INPI 766421 (Portugal) · Ericeira, Portugal · Il pagamento è sempre confermato da una persona — nessun agente tocca il denaro.