BeachFinder — Claude Code MCP server: what it does, how to install
BeachFinder is an MCP server for finding and comparing swimming spots worldwide. It brings current weather, water temperature, wind and UV into your chat.
no license 899 installs updated 2026-07-13
claude mcp add --transport http beachfinder https://beachfinder--beachfinder-app.run.toolsWhat BeachFinder does
BeachFinder is a hosted MCP server at https://beachfinder--beachfinder-app.run.tools. Nothing to authenticate: point the client at that URL and the agent gets 12 read-only tools. The catalogue holds 184,900 swimming places, beaches, lakes and bathing spots, and every result links back to getbeachfinder.com.
Search tools split by activity. search_beaches takes a city or coordinates and ranks matches for swimming, families, warm water, low wind, surf, accessibility or amenities. Other searches cover surf, dive and snorkel, rivers with whitewater, vanlife spots and local guides; the provider tool returns a name, category, rough location and profile link only, while vanlife entries leave out direct contacts.
The rest work from a BeachFinder spot ID. get_spot_details returns stable facts and editorial copy, get_spot_conditions covers water, sky, wind, UV, waves and currents, get_community_conditions aggregates community reports with no identities attached, and compare_spots lines up two to five spots. No ID means no comparison, so run a search first. Dive results carry no visibility or safety estimate.
What it helps with
- find a warm-water beach with light wind in a city you don't know
- compare conditions across a few spots before a trip
- check water temperature and UV for one specific spot
- look up water activity providers near a destination
- pick a surf or snorkel location from mapped spots
Example prompts for the agent
- Find beaches near Lisbon with warm water and low wind right now, and show conditions for each.
- Compare the two spots you just found and tell me which one has less wind.
- Are there snorkel spots nearby, and is there a local guide I can read?
How to install BeachFinder
Platform CLI: remote server
claude mcp add --transport http beachfinder https://beachfinder--beachfinder-app.run.toolsPlatform CLI: remote server
codex mcp add beachfinder --url https://beachfinder--beachfinder-app.run.toolsConfig file
{
"mcpServers": {
"beachfinder": {
"url": "https://beachfinder--beachfinder-app.run.tools"
}
}
}Config file
{
"servers": {
"beachfinder": {
"type": "http",
"url": "https://beachfinder--beachfinder-app.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http beachfinder https://beachfinder--beachfinder-app.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about BeachFinder
How do I install BeachFinder in Claude Code?
Run claude mcp add --transport http beachfinder https://beachfinder--beachfinder-app.run.tools. That registers the hosted endpoint as an HTTP server called beachfinder.
What does BeachFinder do?
It hands the agent 12 read-only tools for finding and comparing swimming spots around the world, with current water, weather, wind and UV signals, guides and activity providers. Results link to getbeachfinder.com.
Do I need an API key?
No. The endpoint is open and every tool only reads data.