Surf Booking

eu.surfbookingPublished by surfbooking.euOfficial publisherv0.2.0Updated Oct 27, 2026

Surf lessons from verified schools and the sea beach by beach, for your level and hour. Read-only.

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

SurfBooking lets an assistant search surf lessons from certified schools, check live surf conditions and forecasts, and get booking links for Portugal, Spain…

What you can do
  • Search and inspect lessons: find bookable surf lessons by query or filters, read full lesson details, and get the secure link a person opens to book and pay.
  • Check conditions: get a spot's current surf score, wave, period and wind plus a multi-day outlook, and rank the best spots today.
  • Choose places: list covered zones and beaches, and recommend spots ranked by live conditions or by surf level.
  • Match conditions to lessons: find upcoming lessons only at beaches whose current sea state meets wave, score, wind or level criteria.
  • Size gear: recommend wetsuit, board, leash and boot sizes from weight, height and level.
When to use it
Useful when someone planning a surf trip or lesson wants to compare schools, prices and times, judge whether conditions suit their level, or pick a beach before booking. It is read-only apart from handing out a payment link, so the human still completes the purchase.
Requirements
A remote streamable HTTP endpoint at the provider's site; no package, environment variable or header is declared. No authentication is declared, so no account or API key is needed to connect.
Before you install
The booking link leads to a real payment page; the server itself does not book or charge, but the human pays there. Lesson availability, prices and conditions come from the provider and can change. Gear sizing is a calculation, not a guarantee of fit.

Installation

In SourceWeft

  1. Open Surf Booking in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/eu.surfbooking%2Fsurfbooking/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "surf-booking": {
      "type": "http",
      "url": "https://www.surfbooking.eu/api/mcp"
    }
  }
}

Tools

10

search_lessons

Search surf lessons

Search bookable surf lessons on SurfBooking by free-text query (zone, beach, level, activity), with optional structured filters (level, maxPrice, date range). Returns upcoming lessons with date, time, spot, level, school, price and a booking link, and says how many matched. All times are local Europe/Lisbon. SurfBooking zones with schools only: Portugal (14 zones with schools), Spain (1 zone with schools). Read-only — does not book or charge anything. It returns lessons, not a ranking of where the surf is good right now. Great for 'aulas de surf na Ericeira', 'beginner lessons this weekend' or 'surf lesson under 40 euros'. This is the general search by place, level, date and price; it does not filter by what the sea is doing, and it does not search hotels.

ParameterstofromlevelqueryrequiredmaxPrice

lesson_details

Lesson details

Get full details of a specific bookable lesson by its id (date, time, level, price, duration, spots left, what's included). Takes a lesson id from a lesson search result. Read-only. Great for 'tell me more about that lesson' or 'o que está incluído nessa aula'.

ParameterslessonIdrequired

surf_forecast

Surf forecast

Get the SurfBooking forecast for a surf spot by name (e.g. 'Carcavelos', 'Ericeira', 'Matosinhos', 'Peniche'). Returns the current 0–10 surf score with label, the level-relevant wave height, period and wind, PLUS a multi-day outlook (the best daylight window per day for the next ~week) so you can answer 'which day this week should I book a lesson?'. The score is level-aware and scored per spot (proprietary). Read-only, SurfBooking zones only: Portugal (27 zones), South Africa (4 zones), Spain (2 zones), Italy (2 zones), times Europe/Lisbon. Books or charges nothing.

Parametersspotrequiredlevel

size_equipment

Gear sizes

Recommend surf gear sizes (wetsuit, board, leash, and boots if a shoe size is given) from a person's weight, height and surf level. Pure EU/Portugal sizing calculation — read-only, books or charges nothing. Useful before picking a lesson so the right gear is ready. Great for 'what wetsuit size do I need' or 'que prancha para 80 kg e 1,80 m'.

ParameterslevelrequiredheightweightrequiredshoeSizeEu

list_zones

Surf zones

List the surf zones/regions covered by SurfBooking (SurfBooking zones only: Portugal (27 zones), South Africa (4 zones), Spain (2 zones), Italy (2 zones)), with how many certified schools each has and whether lessons are bookable. Answers an open 'where can I learn to surf?' / 'best region for beginners?' question. This is about REGIONS and school coverage, never live sea conditions or per-level rankings.

Takes no parameters.

list_spots

Surf spots

List surf beaches (spots), optionally filtered to one zone/region, with bottom type and a short description so you can pick beginner-friendly beaches. Returns beaches, not forecasts or lessons. Great for 'which beaches are in Ericeira' or 'praias boas para iniciantes no Algarve'.

Parameterszone

recommend_spots

Recommended spots

Recommend the top surf beaches in SurfBooking zones right now. Pass `level` for a LEVEL-AWARE ranking — the best spots for a beginner / advanced surfer at this moment, weighted by how well each spot's live wave fits that level. Without `level`, ranks by the live SurfBooking Index (conditions + activity). Best for 'where's good to surf now?' / 'best beach for a beginner today?'. Optionally filter by zone. It ranks beaches for right now, not the best day ahead, and returns no lessons. This returns BEACHES, not lessons.

Parameterszonelevellimit

find_lessons_by_conditions

Lessons for the conditions

Find bookable surf lessons at SurfBooking beaches where current sea conditions match the given criteria: minimum wave height, minimum surf score, wind quality, and/or a specific level. Returns real upcoming lessons with date, time, spot, price and a booking link — only from spots where the sea ACTUALLY meets your threshold right now. Great for 'find beginner lessons when the sea is at least 1m', 'show lessons on days with light wind', or 'surf quando o mar tiver pelo menos 1.5m'. The scoring algorithm is proprietary and runs server-side. Read-only, SurfBooking zones with schools only: Portugal (14 zones with schools), Spain (1 zone with schools). Books or charges nothing. It always returns lessons, never a plain ranking of beaches.

ParametersdayszonelevelwaveMinscoreMinlightWind

best_surf_today

Best surf today

Return the top surf spots in SurfBooking zones right now, ranked by current live conditions. Scores every active SurfBooking spot (wave height, swell period, wind, coast facing) and returns the best ones with wave height, wind, surf score, level suitability, and a link to each beach's page with its lessons. Great for 'what's the best surf spot today?', 'onde está o surf melhor agora?', or 'melhores condições de surf em Portugal'. Conditions are cached from the live forecast and updated every 15 minutes. Read-only, SurfBooking zones only: Portugal (27 zones), South Africa (4 zones), Spain (2 zones), Italy (2 zones). The ranking is by live conditions only, not weighted to one surfer level.

Parameterslevellimit

Version history

1
  1. v0.2.0LatestOct 19, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.