When someone asks an AI where to learn to surf, we return real lessons — beach, level, time, price — ready to book. Not an article. Real lessons, from certified schools.
{
"spot": "Ribeira d'Ilhas",
"date": "2026-06-13",
"time": "09:00",
"level": "iniciante",
"price": "€45",
"book": "surfbooking.eu/reservar/…"
}The night before arriving in Portugal, a tourist asks an AI: "where do I learn to surf this weekend?"
Today, the assistant still answers with a generic map. But SurfBooking has already built the bridge: an index for LLMs and an MCP endpoint that return real lessons — the right beach for the level, at times that actually exist, with the link to book. As assistants open up their connectors, SurfBooking becomes the answer. And whoever connects today — via connector or MCP — gets them right now.
The LLM doesn't "read a page" — it asks for these three things and gets real lessons on the spot.
By beach, zone or level. Returns bookable lessons with day, time, spot, school, price and link.
Price, duration, openings and what's included — wetsuit, board, transport, insurance.
The secure link where the surfer books and pays. The LLM never charges — payment is human.
This is not a mockup — it's what our MCP endpoint returns, right now. Any agent connected to the MCP receives exactly this. (It's not what an AI does on its own today — it's what it gets when you connect it.)
▸ user: "Book me a beginner surf lesson in Portugal this weekend." # the agent calls search_lessons("beginner") and SurfBooking returns: - 13 Jun · 09:00 · Ribeira d'Ilhas · beginner · €45 → book: surfbooking.eu/reservar/... - 14 Jun · 09:00 · Ribeira d'Ilhas · beginner · €45 → book: surfbooking.eu/reservar/... # the booking completes securely. Payment is confirmed by the human.
On Claude.ai (Pro), you add SurfBooking as a custom connector in 20 seconds. Nothing to install, no key.
https://www.surfbooking.eu/api/mcpOn Claude.ai: Settings → Connectors (or Customize → Connectors).
Click "Add custom connector".
Name: SurfBooking. In the "Remote MCP server URL" field, paste the address above. Leave OAuth blank — it's public, no key.
Click Add. Then ask "beginner surf lessons this weekend" — and you get real lessons, ready to book.
The same URL works in any MCP-compatible client, as connectors open up. For the terminal or Claude Desktop, see below.
Nothing to install. Paste into the terminal:
# search for a beginner lesson 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 a client with MCP support: on Claude.ai (Pro) you add the URL as a connector; on Claude Desktop you connect via mcp-remote:
{
"mcpServers": {
"surfbooking": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
}
}
}In the major AI assistants, support for MCP connectors is opening up now. But the way that already works today is the simplest: when any assistant browses the web, it reads our index for LLMs and recommends real SurfBooking lessons — with nothing to connect.
Official SurfBooking partners (hotels, equipment brands) get a scoped API key that limits the MCP to their own data — so a hotel integration never surfaces a competitor's gear brand, and an equipment brand never advertises another hotel chain.
find_hotels returns only the partner's properties. size_equipment gives neutral sizing — no equipment brand is promoted.
size_equipment recommends the partner's own gear catalog. find_hotels is hidden — it's not part of the integration.
Want a scoped key for your brand? Email [email protected] — we verify the partnership and configure the scope.
We open the door to the world's AIs — but with rules that live in the code, not in trust.
It always returns a link; the surfer confirms and pays on SurfBooking. No agent touches your money.
The LLM can only read. It doesn't create, cancel, or change prices or times. The most it does is search for lessons.
Only public lesson information goes out. Student names, emails and phones never leave SurfBooking.
It handles thousands of requests without affecting service to schools — and shuts down in an instant if needed.
Real lessons, from certified schools, ready to book.
Book a lesson