Beach Safety

Get surf/weather conditions for any beach using the beach-safety MCP server.

Quick Usage

mcporter call beach-safety get_beach_report --args '{"beach_name": "Waikiki"}'
mcporter call beach-safety get_beach_report --args '{"beach_name": "Hapuna Beach, Hawaii"}'

Tools Available

Safety Score

Reporting Style

Always include BOTH current UV and daily max UV in surf summaries. The API returns them as current=X (daily max=Y). Never just say "UV max" — say "UV current=X (daily max=Y)" so the user knows if it's day or night at the beach.

Installation (Universal)

1. Install dependencies

pip install -r requirements.txt

(Requires Python 3.10+ and httpx>=0.27.0)

2. Find your install path

After clawhub install beach-safety, the skill lands in your skills directory (e.g. ~/.openclaw/workspace/skills/beach-safety/). The MCP server is at:

<install-dir>/src/server.py

For example, if you installed into ~/.openclaw/workspace/skills/:

# Confirm the path
ls ~/.openclaw/workspace/skills/beach-safety/src/server.py

3. Add to mcporter

Add this to your mcporter config (e.g. ~/.openclaw/workspace/config/mcporter.json):

{
  "mcpServers": {
    "beach-safety": {
      "command": "python3",
      "args": ["<path-to>/src/server.py"]
    }
  }
}

Replace <path-to> with the actual install location from step 2.

4. Test

mcporter call beach-safety get_beach_report --args '{"beach_name": "Waikiki"}'

Data Sources (all free — no API keys)

Notes

• Works for any beach worldwide — just name it
• NOAA surf zone data is most detailed for US coasts
• Open-Meteo marine data covers global oceans
• Some less-famous beaches may not resolve — try adding country/state (e.g. "Kuta Beach, Bali, Indonesia")
• Beach name → coordinates powered by OpenStreetMap + Photons (free)