beach-safety

Comprehensive beach surf conditions via mcporter MCP call. Use when asked about surf, waves, swim conditions, rip currents, or beach safety at any beach worldwide.

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

Quick Usage

bash

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

Tool	Use Case
get_beach_report	Full text report — waves, swell, wind, UV, safety score, recommendations
get_beach_json	Same data as JSON for programmatic use
get_surf_forecast	Surf-specific: wave height, swell, period, direction, rip risk
get_uv_forecast	UV index with sun protection guidance

Safety Score

Score	Meaning	Action
9-10	Generally safe	Enjoy with normal precautions
7-8	Minor concerns	Caution advised
4-6	Caution	Swim near lifeguard
1-3	Dangerous	Stay out of the water

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

bash

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:

text

<install-dir>/src/server.py

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

bash

# 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):

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

bash

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

Data Sources (all free — no API keys)

Source	Data
OpenStreetMap / Photons	Beach name → coordinates
Open-Meteo Marine	Wave height, swell, ocean currents
Open-Meteo Weather	Air temp, wind, precipitation, UV index
NOAA NWS	Rip current risk, surf zone forecast (US only)

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)