Prenotabile dagli LLM

Chiedi una lezione a un LLM.SurfBooking risponde.

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

surfbooking · search_lessons

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

Ognuno collega ciò che gli serve.

SURFISTA

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.

Come collegare

SCUOLA

Gestire la scuola

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.

Come collegare

ISTRUTTORI

Le tue lezioni e i tuoi orari

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.

Come collegare

Cosa può fare l'LLM

10 strumenti (11 con chiave partner). E solo lettura.

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.

search_lessons

Trovare lezioni

Per spiaggia, zona, livello, data o prezzo massimo. Restituisce lezioni prenotabili con giorno, ora, spiaggia, scuola, prezzo e link.

lesson_details

Vedere una lezione

Prezzo, durata, posti e cosa include: muta, tavola, trasporto, assicurazione.

get_booking_link

Dare il link di prenotazione

Il link sicuro dove il surfista prenota e paga. L’agente non incassa mai.

surf_forecast

Il mare in una spiaggia

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?

best_surf_today

Dove è meglio adesso

Le spiagge attive ordinate per condizioni dal vivo, con onda, vento, voto e link.

recommend_spots

Le spiagge giuste per il livello

La stessa onda è buona per un principiante e debole per un avanzato. Questa ordina per quanto ogni spiaggia serve al livello chiesto.

find_lessons_by_conditions

Lezioni solo quando il mare c’è

Lezioni prenotabili solo nelle spiagge dove il mare raggiunge davvero il minimo chiesto di onda, voto o vento debole.

list_zones

Le regioni

Ogni zona con quante scuole ha e se ci sono lezioni da prenotare. Il primo passo di un: dove imparo a surfare?

list_spots

Le spiagge

Spiagge per zona, con tipo di fondo e una breve descrizione, per distinguere quelle buone per principianti dalle altre.

size_equipment

La taglia del materiale

Muta, tavola, leash e scarpette da peso, altezza e livello. Taglie europee, senza promuovere nessun marchio.

find_hotels

Dormire vicino al surf

Gli hotel partner di SurfBooking, per zona o città.

SEMPRE

Nessuno scrive

Tutti leggono soltanto. Nessuno crea, annulla, cambia prezzi o orari, né restituisce dati di allievi.

Esempio illustrativo

Come leggere una risposta MCP.

Esempio illustrativo, con date e link di esempio. Non mostra la disponibilità attuale. Usa la query qui sotto per cercare lezioni disponibili.

agente collegato all'MCP → surfbooking · search_lessons
▸ 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

Incolla l'URL. Fatto.

Su Claude.ai (Pro) aggiungi SurfBooking come connettore personalizzato in 20 secondi. Niente da installare, nessuna chiave.

URL del server MCP remoto
https://www.surfbooking.eu/api/mcp
1

Apri i Connettori

Su Claude.ai: Impostazioni → Connettori (o Personalizza → Connettori).

2

Aggiungi connettore personalizzato

Clicca su "Aggiungi connettore personalizzato".

3

Incolla l'URL

Nome: SurfBooking. Nel campo "URL del server MCP remoto", incolla l'indirizzo qui sopra. Lascia OAuth vuoto — è pubblico, senza chiave.

4

Aggiungi e chiedi

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

Una chiamata e hai lezioni reali

Senza installare nulla. Incolla nel terminale:

terminal
# 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:

claude_desktop_config.json
{
  "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

Ogni marca vede solo i propri dati.

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.

HOTEL

Chiave partner alberghiero

find_hotels restituisce solo le strutture del partner. size_equipment dà un sizing neutro — nessun marchio di attrezzatura viene promosso.

ATTREZZ.

Chiave marca di attrezzatura

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

Il connettore privato della tua scuola.

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.

intestazione della chiave della scuola
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…
list_my_schools

La scuola della chiave

Il nome della scuola, il tuo ruolo, i permessi della chiave e quando scade.

get_school_briefing

La tua giornata in una domanda

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).

get_school_schedule

L’orario

Le lezioni tra due date, fino a 14 giorni: ora, spiaggia, livello, istruttori e posti liberi. Un istruttore vede solo le sue.

get_bookings_summary

Il riepilogo delle prenotazioni

Conteggi per giorno, fino a 31 giorni: confermate, check-in, assenze e partecipanti. Nessun importo in denaro. Titolare, o staff con accesso ai report.

get_lesson_roster

Chi viene a una lezione

Solo il nome, il check-in e le taglie già registrate. Nessun contatto, salute, allergia o data di nascita.

get_stock_summary

Lo stock

L’attrezzatura per categoria e taglia: quantità, in riparazione e disponibile.

get_conditions_for_my_lessons

Il mare delle tue lezioni

Per le lezioni dei prossimi giorni, fino a 7: voto, onda, periodo, vento e un avviso di rischio per il livello della lezione.

review_week_with_sea

Rivedere la settimana con il mare

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.

prepare_lesson_move

Preparare lo spostamento di una lezione

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.

prepare_stock_change

Preparare una modifica dello stock

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.

list_pending_proposals

Le proposte

Le proposte preparate e lo stato di ciascuna. Il titolare le vede tutte; lo staff vede le proprie.

MAI

Cosa non fa

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:

claude_desktop_config.json
{
  "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?

L'LLM mostra. Il controllo è tuo.

Apriamo la porta alle IA del mondo — ma con regole che vivono nel codice, non nella fiducia.

DENARO

L'LLM non incassa mai

Restituisce sempre un link; il surfista conferma e paga su SurfBooking. Nessun agente tocca i tuoi soldi.

PRENOTAZIONI

Non tocca mai nulla

L'LLM può solo leggere. Non crea, non cancella, non cambia prezzi né orari. Al massimo cerca lezioni.

ALLIEVI

Zero dati degli allievi

Esce solo l'informazione pubblica della lezione. Nomi, email e telefoni degli allievi non escono mai da SurfBooking.

CONTROLLO

Lo spegni quando vuoi

Regge migliaia di richieste senza intaccare il servizio alle scuole — e si chiude in un istante se serve.

La costa di Ericeira

Pronta per la prossima onda

Quando qualcuno chiede surf a un LLM, SurfBooking risponde.

Lezioni reali, di scuole, pronte da prenotare.

Prenota una lezione

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

Torna su