Where and when to surf near a place: forecasts and tides for 2,435 surf spots.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the person asks where or when to surf around a place. when is in the person's words (tomorrow morning, Saturday, this weekend); default the next 24 hours. Not for one spot's full hours: use get_surf_forecast. Answers surf spots near the place, ranked for the time asked (today, tomorrow, tomorrow morning, this weekend, a date): each spot's best window in that time with its wave height, period, wind and why it ranks there, and the spots with nothing good in that time last; within radius_km (default 30, at most 100).
a town, a coast or a spot: Lisbon, Hossegor, Supertubos
in people's words: today, tomorrow morning, this weekend, Saturday, 2026-11-28
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http supersurf https://mcp.supersurf.app/mcp
Use this when the person asks where or when to surf around a place. when is in the person's words (tomorrow morning, Saturday, this weekend); default the next 24 hours. Not for one spot's full hours: use get_surf_forecast. Answers surf spots near the place, ranked for the time asked (today, tomorrow, tomorrow morning, this weekend, a date): each spot's best window in that time with its wave height, period, wind and why it ranks there, and the spots with nothing good in that time last; within radius_km (default 30, at most 100).
| Argument | Type | Description |
|---|---|---|
| lat | number | |
| lon | number | |
| near | string | a town, a coast or a spot: Lisbon, Hossegor, Supertubos |
| when | string | in people's words: today, tomorrow morning, this weekend, Saturday, 2026-11-28 |
| limit | integer | |
| radius_km | integer |
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"near": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "a town, a coast or a spot: Lisbon, Hossegor, Supertubos"
},
"when": {
"type": "string",
"maxLength": 60,
"description": "in people's words: today, tomorrow morning, this weekend, Saturday, 2026-11-28"
},
"limit": {
"type": "integer",
"maximum": 40,
"minimum": 1
},
"radius_km": {
"type": "integer",
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}Use this when the person asks about the waves, wind or conditions at one spot. Not for comparing spots: use find_best_surf. Not for tides: use get_tide_times. Answers one spot's forecast: now, its next good window, each of the next days (at most 16) with its best hours, and hour by hour the wave height, swell period and direction, wind speed and direction (offshore or onshore at this spot), and sunrise and sunset; each number names its source and when it was made.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| spot* | string | a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor) |
{
"type": "object",
"required": [
"spot"
],
"properties": {
"days": {
"type": "integer",
"maximum": 16,
"minimum": 1
},
"spot": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor)"
}
},
"additionalProperties": false
}Use this when the person asks about the tide at a spot. Not for waves or wind: use get_surf_forecast. Answers a spot's high and low tides for the coming days (at most 14) in its own time zone, with heights, worked out from the tide constants of the nearest station; says so where there is none.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| spot* | string | a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor) |
{
"type": "object",
"required": [
"spot"
],
"properties": {
"days": {
"type": "integer",
"maximum": 14,
"minimum": 1
},
"spot": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor)"
}
},
"additionalProperties": false
}Use this when the person asks for lessons, a board to rent or a surf shop near a spot. kind keeps to one: school, rental or shop. Not for the waves: use get_surf_forecast. Answers surf schools, board rentals and surf shops within 2 km of a spot, each with its name, kind, distance, address and link where known, from Apple Maps' places.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| spot* | string | a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor) |
{
"type": "object",
"required": [
"spot"
],
"properties": {
"kind": {
"enum": [
"school",
"rental",
"shop"
],
"type": "string"
},
"spot": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "a surf spot's id as search_surf_spots or list_surf_spots_near show it, or its name (Ericeira, Supertubos, Hossegor)"
}
},
"additionalProperties": false
}Use this when the person asks what surf spots are around a place or around them. Give near (a town, area or spot name) or lat and lon. Not for where the surf is best: use find_best_surf. Answers the nearest surf spots to a spot, town or area named in near, or to lat and lon: each with its distance in km, kind and which way it faces; at most 40.
| Argument | Type | Description |
|---|---|---|
| lat | number | |
| lon | number | |
| near | string | a town, a coast or a spot: Lisbon, Hossegor, Supertubos |
| limit | integer |
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"near": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "a town, a coast or a spot: Lisbon, Hossegor, Supertubos"
},
"limit": {
"type": "integer",
"maximum": 40,
"minimum": 1
}
},
"additionalProperties": false
}Use this when the person names a surf spot, a town or a country and you need the spot's id. country is a two-letter code (PT) to keep to one country. Not for spots near a place: use list_surf_spots_near. Answers surf spots whose name, town, area or country match the words in any order, plurals, case or a typo: each with its id, name, town, country, kind (beach break, reef, point) and which way it faces; the closest names when nothing matches; at most 50.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | |
| country | string | a two-letter country code: PT, FR, US |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "a two-letter country code: PT, FR, US"
}
},
"additionalProperties": false
}Use this when the person asks to tell Supersurf something: a wrong forecast, a missing spot, an idea. Only their words, never include the conversation. Not for questions about the surf: answer from the other tools.
| Argument | Type | Description |
|---|---|---|
| kind* | string | problem, idea or question |
| text* | string | |
| tool | string |
{
"type": "object",
"required": [
"kind",
"text"
],
"properties": {
"kind": {
"enum": [
"problem",
"idea",
"question"
],
"type": "string",
"description": "problem, idea or question"
},
"text": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"tool": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.