{
  "markdown": "# Beachmap MCP server\n\nRemote [Model Context Protocol](https://modelcontextprotocol.io) server for **[Beachmap](https://europebeachmap.com)** — 511 of Europe's best beaches across 31 countries, each with its sea-surface temperature (°C, from NOAA OISST), sand type, best months, swimming conditions, surf quality, setting and Blue Flag status.\n\nFree, read-only, no key or account. Listed in the [official MCP registry](https://registry.modelcontextprotocol.io) as `com.europebeachmap/beachmap`.\n\n## Endpoint\n\n```\nhttps://europebeachmap.com/mcp\n```\n\nStreamable HTTP transport, stateless, no authentication.\n\n**Claude Code:**\n\n```bash\nclaude mcp add --transport http beachmap https://europebeachmap.com/mcp\n```\n\n**Claude / ChatGPT / other clients with remote MCP support** — add `https://europebeachmap.com/mcp` as a custom connector, or use the generic config:\n\n```json\n{ \"mcpServers\": { \"beachmap\": { \"type\": \"http\", \"url\": \"https://europebeachmap.com/mcp\" } } }\n```\n\n## Tools\n\n| Tool | Does | Example question it answers |\n|---|---|---|\n| `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\" |\n| `get_beach` | Full profile of one beach by id or name | \"Tell me about Ksamil Beaches\" |\n| `warmest_beaches` | Beaches ranked by typical warm-season sea temperature | \"Where is the sea warmest in Portugal in October?\" |\n| `beaches_best_in_month` | Beaches whose best-time window includes a month | \"Where should I go to the beach in October?\" |\n\n## Run it yourself\n\nThe server reads the open Beachmap dataset from disk:\n\n```bash\nnpm install\ncurl -o beaches.json https://europebeachmap.com/data/beaches.json\nBEACHES_PATH=./beaches.json PORT=8765 node server.mjs\n# MCP endpoint on http://127.0.0.1:8765/mcp\n```\n\n## Data & licence\n\n- **Code:** MIT (this repository).\n- **Data:** [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — credit \"Beachmap\" and link to [europebeachmap.com](https://europebeachmap.com). Sea temperatures are the 30-year (1995–2024) mean mid-August SST from NOAA OISST v2.1 (public domain), sampled at each beach's nearest ocean cell.\n- Dataset downloads: [JSON](https://europebeachmap.com/data/beaches.json) · [CSV](https://europebeachmap.com/data/beaches.csv) · [GeoJSON](https://europebeachmap.com/data/beaches.geojson)\n- Docs page: [europebeachmap.com/mcp-server](https://europebeachmap.com/mcp-server/)\n\nCitation:\n\n```\nBeach data: Beachmap (https://europebeachmap.com), CC BY 4.0\n```\n",
  "bytes": 2545,
  "sha": "2cfb4e6fbcaa4c754ed4566731cc8a295270b8d76d40b6ebd794dcbd594539ac",
  "repo_slug": "flightmussy/beachmap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_europebeachmap_beachmap_29efcca3/readme"
}