Surf Booking
Surf lessons from verified schools and the sea beach by beach, for your level and hour. Read-only.
| Endpoint | https://www.surfbooking.eu/api/mcp (streamable-http) |
|---|---|
| Registry version | 0.2.0 |
| Now | 10 tools · grade A (97) · pin ts_7c70de50743e12dd0d6ebfd8142afcb5 · protocol 2025-06-18 |
| First / last listed | 2026-10-28 06:47 UTC / 2026-10-28 06:47 UTC |
| Grade over time | 2026-10-28: A (97), 10 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_lessons lesson_details get_booking_link surf_forecast size_equipment list_zones list_spots recommend_spots find_lessons_by_conditions best_surf_today
search_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 (2 zones with params: query*, level, maxPrice, from, to |
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'. params: lessonId* |
get_booking_link | Get the secure SurfBooking link a user opens to BOOK and PAY for a lesson. NEVER books or charges — only returns the URL; the human completes the purchase. Great for 'send me the payment link' or 'manda-me o link para pagar essa aula'. params: lessonId* |
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 (pr params: spot*, level |
size_equipment | 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'. params: weight*, height, level*, shoeSizeEu |
list_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 r params: none |
list_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'. params: zone |
recommend_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 b params: zone, level, limit |
find_lessons_by_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', ' params: waveMin, scoreMin, level, zone, days, lightWind |
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 'melhore params: limit, level |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.