Surf Booking.PTMCP
ManifestAgentIntelligenz-SchichtTechnologieVerfassungKIMCPPartner API
Buchbar durch LLMs

Frag ein LLM nach einem Kurs.SurfBooking antwortet.

Wenn jemand eine KI fragt, wo man surfen lernt, geben wir echte Kurse zurück — Strand, Level, Uhrzeit, Preis — bereit zum Buchen. Keinen Artikel. Echte Kurse von zertifizierten Schulen.

MCP live · jeder kompatible Assistent verbindet sich und bekommt echte Kurse
surfbooking.eu/api/mcp
surfbooking · search_lessons
search_lessons
{
  "spot":   "Ribeira d'Ilhas",
  "date":   "2026-06-13",
  "time":   "09:00",
  "level":  "iniciante",
  "price":  "€45",
  "book":   "surfbooking.eu/reservar/…"
}
Der Moment

Am Abend vor der Ankunft in Portugal fragt ein Tourist eine KI: "wo lerne ich dieses Wochenende surfen?"

Heute antwortet der Assistent noch mit einer generischen Karte. Aber SurfBooking hat die Brücke schon gebaut: einen Index für LLMs und einen MCP-Endpoint, die echte Kurse zurückgeben — den richtigen Strand für das Level, zu Zeiten, die es wirklich gibt, mit dem Link zum Buchen. Sobald die Assistenten ihre Konnektoren öffnen, wird SurfBooking die Antwort. Und wer heute schon verbindet — über Konnektor oder MCP — bekommt sie sofort.

Was das LLM kann

11 Werkzeuge. Und nur lesen.

Das LLM liest keine Seite: es fragt nach einer dieser Sachen und bekommt sofort echte Daten, samt Zustand des Meeres an jedem Strand.

search_lessons

Kurse finden

Nach Strand, Region, Niveau, Datum oder Höchstpreis. Gibt buchbare Kurse mit Tag, Uhrzeit, Strand, Schule, Preis und Link zurück.

lesson_details

Einen Kurs ansehen

Preis, Dauer, Plätze und was enthalten ist: Neopren, Board, Transport, Versicherung.

get_booking_link

Den Buchungslink geben

Der sichere Link, wo der Surfer bucht und bezahlt. Der Agent kassiert nie.

surf_forecast

Das Meer an einem Strand

Eine Note von 0 bis 10, auf das Niveau abgestimmt, mit Welle, Periode und Wind, und dem besten Fenster jedes Tages. Sie beantwortet: an welchem Tag soll ich buchen?

best_surf_today

Wo es gerade am besten ist

Die aktiven Strände nach Live-Bedingungen sortiert, mit Welle, Wind, Note und Link.

recommend_spots

Die richtigen Strände für das Niveau

Dieselbe Welle ist gut für Anfänger und schwach für Fortgeschrittene. Diese sortiert danach, wie gut jeder Strand zum gefragten Niveau passt.

find_lessons_by_conditions

Kurse nur, wenn das Meer liefert

Buchbare Kurse nur an Stränden, wo das Meer das gefragte Minimum an Welle, Note oder schwachem Wind wirklich erfüllt.

list_zones

Die Regionen

Jede Region mit der Zahl der Schulen und ob Kurse buchbar sind. Der erste Schritt eines: wo lerne ich surfen?

list_spots

Die Strände

Strände nach Region, mit Bodenart und kurzer Beschreibung, um die anfängerfreundlichen von den anderen zu unterscheiden.

size_equipment

Die Größe der Ausrüstung

Neopren, Board, Leash und Schuhe aus Gewicht, Größe und Niveau. Europäische Größen, ohne eine Marke zu bewerben.

find_hotels

Neben dem Surf schlafen

Die Partnerhotels von SurfBooking, nach Region oder Stadt.

IMMER

Keines schreibt

Alle lesen nur. Keines erstellt, storniert, ändert Preise oder Zeiten, oder gibt Schülerdaten zurück.

Läuft

Die echte Antwort des MCP.

Das ist kein Mockup — das ist es, was unser MCP-Endpoint jetzt zurückgibt. Jeder Agent, der mit dem MCP verbunden ist, bekommt genau das. (Es ist nicht das, was eine KI heute von allein tut — es ist das, was sie bekommt, wenn du sie verbindest.)

Agent mit dem MCP verbunden → surfbooking · search_lessons
▸ Nutzer: "Buche mir dieses Wochenende einen Surfkurs für Anfänger in Portugal."
# der Agent ruft search_lessons("Anfänger") auf und SurfBooking liefert:
- 13 Jun · 09:00 · Ribeira d'Ilhas · Anfänger · €45 → buchen: surfbooking.eu/reservar/...
- 14 Jun · 09:00 · Ribeira d'Ilhas · Anfänger · €45 → buchen: surfbooking.eu/reservar/...
# die Buchung wird sicher abgeschlossen. Die Zahlung bestätigt der Mensch.
Mit Claude.ai verbinden

URL einfügen. Fertig.

Auf Claude.ai (Pro) fügst du SurfBooking in 20 Sekunden als eigenen Konnektor hinzu. Nichts zu installieren, kein Schlüssel.

URL des Remote-MCP-Servers
https://www.surfbooking.eu/api/mcp
1

Öffne die Connectors

Auf Claude.ai: Einstellungen → Konnektoren (oder Anpassen → Konnektoren).

2

Eigenen Connector hinzufügen

Klicke auf "Eigenen Konnektor hinzufügen".

3

URL einfügen

Name: SurfBooking. Im Feld "URL des Remote-MCP-Servers" die Adresse von oben einfügen. OAuth leer lassen — es ist öffentlich, ohne Schlüssel.

4

Hinzufügen und fragen

Klicke auf Hinzufügen. Dann frag "Surfkurse für Anfänger an diesem Wochenende" — und du bekommst echte Kurse, bereit zum Buchen.

Dieselbe URL funktioniert in jedem MCP-kompatiblen Client, sobald die Connectors freigeschaltet werden. Für das Terminal oder Claude Desktop siehe unten.

Probier's aus

Ein Aufruf und du hast echte Kurse

Nichts zu installieren. Ins Terminal einfügen:

terminal
# einen Anfängerkurs suchen
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 einem Client mit MCP-Unterstützung: auf Claude.ai (Pro) fügst du die URL als Konnektor hinzu; in Claude Desktop verbindest du über mcp-remote:

claude_desktop_config.json
{
  "mcpServers": {
    "surfbooking": {
      "command": "npx",
      "args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
    }
  }
}

In den großen KI-Assistenten öffnet sich die Unterstützung für MCP-Konnektoren gerade. Aber der Weg, der heute schon funktioniert, ist der einfachste: Wenn ein Assistent im Web unterwegs ist, liest er unseren Index für LLMs und empfiehlt echte SurfBooking-Kurse — ganz ohne Verbindung.

Partner-Integrationen

Jede Marke sieht nur ihre eigenen Daten.

Offizielle SurfBooking-Partner (Hotels, Ausrüstungsmarken) bekommen einen Schlüssel mit Scope, der das MCP auf ihre eigenen Daten begrenzt — damit eine Hotel-Integration nie eine konkurrierende Board-Marke zeigt und eine Ausrüstungsmarke nie eine fremde Hotelkette bewirbt.

HOTEL

Schlüssel für Hotelpartner

find_hotels gibt nur die Häuser des Partners zurück. size_equipment liefert neutrales Sizing — keine Ausrüstungsmarke wird beworben.

AUSRÜST.

Schlüssel für Ausrüstungsmarken

size_equipment empfiehlt den eigenen Katalog der Marke. find_hotels bleibt verborgen — es gehört nicht zu dieser Integration.

Willst du einen Schlüssel mit Scope für deine Marke? Schreib eine E-Mail an [email protected] — wir prüfen die Partnerschaft und richten den Scope ein.

Für Surfschulen

Der private Connector deiner Schule.

Eine eigene Tür, getrennt von der öffentlichen, nur für deine Schule. Der Assistent liest, was deine Rolle in SurfBooking OS schon sieht, und kann zwei Änderungen vorbereiten, die erst passieren, wenn der Inhaber sie im OS bestätigt.

Stand heute: standardmäßig ausgeschaltet und noch nicht mit einem echten Assistenten geprüft. Solange es aus ist, antwortet die Adresse mit 404.

Den Schlüssel erstellt der Inhaber in SurfBooking OS, im Fenster «Assistentes ligados»: Dort widerruft er ihn, sieht die Anfragen des Assistenten und bestätigt Vorschläge.

Header mit dem Schulschlüssel
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…
list_my_schools

Die Schule des Schlüssels

Der Name der Schule, deine Rolle, die Rechte des Schlüssels und wann er abläuft.

get_school_schedule

Der Stundenplan

Die Kurse zwischen zwei Daten, bis zu 14 Tage: Uhrzeit, Strand, Niveau, Lehrer und freie Plätze. Ein Lehrer sieht nur seine eigenen.

get_bookings_summary

Die Buchungsübersicht

Zählungen pro Tag, bis zu 31 Tage: bestätigt, eingecheckt, nicht erschienen und Teilnehmer. Keine Geldbeträge. Inhaber oder Team mit Zugriff auf Berichte.

get_lesson_roster

Wer in einem Kurs ist

Nur der Vorname, der Check-in und die schon erfassten Größen. Keine Kontakte, Gesundheit, Allergien oder Geburtsdaten.

get_stock_summary

Der Bestand

Das Material nach Kategorie und Größe: Menge, in Reparatur und verfügbar.

get_conditions_for_my_lessons

Das Meer für deine Kurse

Für die Kurse der nächsten Tage, bis zu 7: Bewertung, Welle, Periode, Wind und ein Risikohinweis für das Kursniveau.

prepare_lesson_move

Das Verschieben eines Kurses vorbereiten

Erstellt einen offenen Vorschlag mit neuem Datum und neuer Uhrzeit. Der Kurs ändert sich nicht. Kurse, die schon Schüler haben, werden in dieser Version nicht angenommen.

prepare_stock_change

Eine Bestandsänderung vorbereiten

Erstellt einen offenen Vorschlag, um Einheiten zu setzen, hinzuzufügen oder zu entfernen, bis zu 30 Zeilen. Der Bestand ändert sich nicht und fällt nie unter null.

list_pending_proposals

Die Vorschläge

Die vorbereiteten Vorschläge und der Stand jedes einzelnen. Der Inhaber sieht alle, das Team sieht die eigenen.

NIE

Was es nicht tut

Es rührt kein Geld an: Zahlungen, Erstattungen, Preise oder Stornierungen. Es wendet nichts selbst an: Jede Änderung wartet auf die Bestätigung des Inhabers im OS, mit denselben Prüfungen wie im Dashboard.

Der Schlüssel wird mit der Sitzung des Inhabers in SurfBooking OS erzeugt und nur einmal angezeigt. Wir speichern nur seinen Hash, er gilt 30, 90 oder 365 Tage und lässt sich jederzeit widerrufen. Der Bildschirm in den Einstellungen kommt in der nächsten Phase.

In Claude Desktop verbindest du dich über mcp-remote, mit dem Schlüssel in einem Header:

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_…" }
    }
  }
}

Der benutzerdefinierte Connector von Claude.ai im Web und der von ChatGPT erlauben keinen Schlüssel im Header, nur OAuth, das dieser Connector noch nicht hat. Heute funktioniert er nur mit Clients, die den Header senden. Kein Client wurde live geprüft.

Und deine Sicherheit?

Das LLM zeigt. Die Kontrolle liegt bei dir.

Wir öffnen die Tür für die KIs der Welt — aber mit Regeln, die im Code stehen, nicht im Vertrauen.

GELD

Das LLM kassiert nie

Es liefert immer einen Link; der Surfer bestätigt und bezahlt auf SurfBooking. Kein Agent fasst dein Geld an.

BUCHUNGEN

Es ändert nie etwas

Das LLM kann nur lesen. Es legt nichts an, storniert nichts, ändert weder Preise noch Zeiten. Mehr als Kurse suchen macht es nicht.

SCHÜLER

Null Schülerdaten

Nach außen gehen nur öffentliche Kursinformationen. Namen, E-Mails und Telefonnummern von Schülern verlassen SurfBooking nie.

KONTROLLE

Du schaltest es ab, wann du willst

Es hält Tausende Anfragen aus, ohne den Service für die Surfschulen zu beeinträchtigen — und wird im Nu abgeschaltet, wenn nötig.

Bereit für die nächste Welle

Wenn jemand ein LLM nach Surf fragt,
antwortet SurfBooking.

Echte Kurse, von zertifizierten Surfschulen, bereit zur Buchung.

Kurs buchen