Beachmap — Europe Beach Data

Official4 tools

by Flightmussy · JavaScript

Europe's 478 best beaches: sea temperature, sand, best months, swimming, surf. Free, CC BY 4.0.

Captured live from the server via tools/list.

search_beaches

Search and filter 478 top European beaches. All filters optional and combinable. Returns compact records; use get_beach for a full profile.

Parameters8

query	string	optional	Free-text match on name, place, setting, description and tags (e.g. "snorkelling", "dunes", "Algarve")
country	string	optional	ISO-2 code or country name (e.g. "PT" or "Portugal")
category	string	optional	Beach character
sand	string	optional	Sand/shore match, e.g. "white", "golden", "pebble"
blue_flag	boolean	optional	Only Blue Flag awarded beaches
min_sea_temp_c	number	optional	Minimum typical warm-season sea temperature in °C
month	string \| number	optional	Only beaches in season that month (name or 1-12)
limit	integer	optional	Max results, default 10, max 50

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text match on name, place, setting, description and tags (e.g. \"snorkelling\", \"dunes\", \"Algarve\")"
    },
    "country": {
      "type": "string",
      "description": "ISO-2 code or country name (e.g. \"PT\" or \"Portugal\")"
    },
    "category": {
      "type": "string",
      "enum": [
        "tropical",
        "wild",
        "resort",
        "cold",
        "exotic",
        "surf"
      ],
      "description": "Beach character"
    },
    "sand": {
      "type": "string",
      "description": "Sand/shore match, e.g. \"white\", \"golden\", \"pebble\""
    },
    "blue_flag": {
      "type": "boolean",
      "description": "Only Blue Flag awarded beaches"
    },
    "min_sea_temp_c": {
      "type": "number",
      "description": "Minimum typical warm-season sea temperature in °C"
    },
    "month": {
      "type": [
        "string",
        "number"
      ],
      "description": "Only beaches in season that month (name or 1-12)"
    },
    "limit": {
      "type": "integer",
      "description": "Max results, default 10, max 50"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_beach

Full profile of one beach by id (from search results) or by name.

Parameters1

id_or_name

string

required

Beach id (e.g. "ksamil-beaches-al") or beach name (e.g. "Ksamil Beaches")

Raw schema

{
  "type": "object",
  "properties": {
    "id_or_name": {
      "type": "string",
      "description": "Beach id (e.g. \"ksamil-beaches-al\") or beach name (e.g. \"Ksamil Beaches\")"
    }
  },
  "required": [
    "id_or_name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

warmest_beaches

European beaches ranked by typical warm-season sea temperature, warmest first. Optionally filter by country and/or month in season.

Parameters3

country	string	optional	ISO-2 code or country name
month	string \| number	optional	Only beaches in season that month (name or 1-12)
limit	integer	optional	Max results, default 10, max 50

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO-2 code or country name"
    },
    "month": {
      "type": [
        "string",
        "number"
      ],
      "description": "Only beaches in season that month (name or 1-12)"
    },
    "limit": {
      "type": "integer",
      "description": "Max results, default 10, max 50"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

beaches_best_in_month

Beaches whose best-time window includes a given month, warmest sea first. Good for "where should I go in October?"

Parameters3

month	string \| number	required	Month name or number 1-12
country	string	optional	ISO-2 code or country name
limit	integer	optional	Max results, default 15, max 50

Raw schema

{
  "type": "object",
  "properties": {
    "month": {
      "type": [
        "string",
        "number"
      ],
      "description": "Month name or number 1-12"
    },
    "country": {
      "type": "string",
      "description": "ISO-2 code or country name"
    },
    "limit": {
      "type": "integer",
      "description": "Max results, default 15, max 50"
    }
  },
  "required": [
    "month"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md2 KBView on GitHub

Beachmap MCP server

Remote Model Context Protocol server for Beachmap — 478 of Europe's best beaches across 31 countries, each with typical warm-season sea temperature (°C), sand type, best months, swimming conditions, surf quality, setting and Blue Flag status.

Free, read-only, no key or account. Listed in the official MCP registry as com.europebeachmap/beachmap.

Endpoint

code

https://europebeachmap.com/mcp

Streamable HTTP transport, stateless, no authentication.

Claude Code:

bash

claude mcp add --transport http beachmap https://europebeachmap.com/mcp

Claude / ChatGPT / other clients with remote MCP support — add https://europebeachmap.com/mcp as a custom connector, or use the generic config:

json

{ "mcpServers": { "beachmap": { "type": "http", "url": "https://europebeachmap.com/mcp" } } }

Tools

Tool	Does	Example question it answers
`search_beaches`	Search + filter all beaches: free text, country, category, sand, Blue Flag, min sea temperature, month in season	"Blue Flag white-sand beaches with sea over 25°C"
`get_beach`	Full profile of one beach by id or name	"Tell me about Ksamil Beaches"
`warmest_beaches`	Beaches ranked by typical warm-season sea temperature	"Where is the sea warmest in Portugal in October?"
`beaches_best_in_month`	Beaches whose best-time window includes a month	"Where should I go to the beach in October?"

Run it yourself

The server reads the open Beachmap dataset from disk:

bash

npm install
curl -o beaches.json https://europebeachmap.com/data/beaches.json
BEACHES_PATH=./beaches.json PORT=8765 node server.mjs
# MCP endpoint on http://127.0.0.1:8765/mcp

Data & licence

Code: MIT (this repository).
Data: CC BY 4.0 — credit "Beachmap" and link to europebeachmap.com. Sea temperatures are typical warm-season values (climatological, not live readings).
Dataset downloads: JSON · CSV · GeoJSON
Docs page: europebeachmap.com/mcp-server

Citation:

code

Beach data: Beachmap (https://europebeachmap.com), CC BY 4.0

Install

Tools (4)

search_beachesget_beachwarmest_beachesbeaches_best_in_month

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://europebeachmap.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "beachmap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://europebeachmap.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.