Surf Booking.PTMCP
ManifestoAgentIntelligence LayerTechnologyConstitutionAIMCPPartner API
Bookable by LLMs

Ask an LLM for a lesson.SurfBooking answers.

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.

MCP live · any compatible assistant connects and gets real lessons
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/…"
}
The moment

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.

What the LLM can do

Three things. And read-only.

The LLM doesn't "read a page" — it asks for these three things and gets real lessons on the spot.

search_lessons

Find lessons

By beach, zone or level. Returns bookable lessons with day, time, spot, school, price and link.

lesson_details

View a lesson

Price, duration, openings and what's included — wetsuit, board, transport, insurance.

get_booking_link

Give the booking link

The secure link where the surfer books and pays. The LLM never charges — payment is human.

Live

The real MCP response.

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

agent connected to the MCP → surfbooking · search_lessons
▸ 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.
Connect to Claude.ai

Paste the URL. Done.

On Claude.ai (Pro), you add SurfBooking as a custom connector in 20 seconds. Nothing to install, no key.

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

Open Connectors

On Claude.ai: Settings → Connectors (or Customize → Connectors).

2

Add custom connector

Click "Add custom connector".

3

Paste the URL

Name: SurfBooking. In the "Remote MCP server URL" field, paste the address above. Leave OAuth blank — it's public, no key.

4

Add and ask

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.

Try it

One call and you have real lessons

Nothing to install. Paste into the terminal:

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:

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

Partner integrations

Each brand sees only its own data.

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.

HOTEL

Hotel partner key

find_hotels returns only the partner's properties. size_equipment gives neutral sizing — no equipment brand is promoted.

GEAR

Equipment brand key

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.

What about your safety?

The LLM shows. The control is yours.

We open the door to the world's AIs — but with rules that live in the code, not in trust.

MONEY

The LLM never charges

It always returns a link; the surfer confirms and pays on SurfBooking. No agent touches your money.

BOOKINGS

It never changes anything

The LLM can only read. It doesn't create, cancel, or change prices or times. The most it does is search for lessons.

STUDENTS

Zero student data

Only public lesson information goes out. Student names, emails and phones never leave SurfBooking.

CONTROL

Turn it off whenever you want

It handles thousands of requests without affecting service to schools — and shuts down in an instant if needed.

Ready for the next wave

When someone asks an LLM for surf,
SurfBooking answers.

Real lessons, from certified schools, ready to book.

Book a lesson