PickADive Scuba Diving README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the PickADive Scuba Diving listing page.
PickADive MCP Server
Live dive-conditions data for AI agents — forecast windows, best-time climatology, marine-life seasonality, and site facts for 4,800+ dive sites worldwide.
Hosted at https://pickadive.com/mcp — nothing to install
Setup · Tools · What you can do · Data & honesty · Security · Support
What can you do with it?
- "Where can I dive near Boston this Saturday?" — ranked favorable and moderate forecast windows near any place for any day, with wave height, wind, timing, and site links.
- "When should I book Komodo?" — month-by-month climatology for a destination: the share of days historically favorable, typical water temperature and seas, and marine-life season windows.
- "When and where do whale sharks peak?" — species seasonality from 236k+ recorded GBIF sightings: peak month and regional season windows.
- "How deep is Molasses Reef, and what are the hazards?" — public facts for any named dive site: depths, difficulty, shore/boat access, hazards, entry and exit notes.
- "Where in the world is good for diving right now?" — regions ranked by favorable windows over the next ~72 hours.
Setup
Add the server to any MCP-compatible client — no key, no OAuth:
| Client | How |
|---|---|
| Claude Code | claude mcp add --transport http pickadive https://pickadive.com/mcp |
| Claude.ai / Desktop | Settings → Connectors → Add custom connector → https://pickadive.com/mcp |
| Cursor · Windsurf · VS Code · Zed | Add the JSON block above to your MCP config |
| Gemini CLI | gemini mcp add --transport http pickadive https://pickadive.com/mcp |
| Local-only clients | Bridge with npx mcp-remote https://pickadive.com/mcp |
Discovery manifest: /.well-known/mcp.json ·
Agent onboarding: /llms.txt
Tools
| Tool | Input | Output |
|---|---|---|
find_dive_windows | {near | lat+lng, day?, radius_km?} | Ranked windows: quality, wave_m, wind_kn, timing, site links |
best_time_to_dive | {destination} | 12-month climatology + marine-life seasons + source page |
species_seasonality | {species, lat?, lng?} | Peak month, regional season windows, sighting counts |
site_facts | {site} | Depths, difficulty, access, hazards, entry/exit, cert level |
top_dive_regions | {} | World regions ranked by favorable windows (~72 h) |
All values are metric with unit-suffixed field names (max_depth_m,
wave_m, distance_km); wind is knots — the marine convention
everywhere. Tool descriptions instruct agents to convert for US users.
Every response includes a source link — please cite pickadive.com
when presenting results.
Data & honesty
Answers come from PickADive's own pipeline: hourly conditions gradings across 4,800+ curated dive sites (Open-Meteo marine + weather, NOAA tides), multi-year climatology, and 236k+ GBIF species sighting records.
Two rules the server never breaks:
- Forecasts are planning context, never a safety clearance. Every response carries the disclaimer; agents should keep it.
- Missing data is stated, never invented. Thin destinations return an honest "not enough history" rather than a guess.
Security
| Read-only by design | No write tools — the server cannot create, modify, or delete anything. The worst a prompt injection can achieve through it is reading public dive data. |
| No auth, no tokens, no user data | Nothing to leak, phish, or exfiltrate; connecting grants an agent no identity. |
| Stateless JSON mode | One POST in, one JSON body out; no sessions, no server-push channel. |
| HTTPS only, CORS open | Read-only public data. |
Transport & limits
Streamable HTTP (JSON-RPC 2.0 over POST), stateless — protocol versions
2024-11-05 → 2025-06-18.
Free for individual and assistant use at fair, non-bulk volumes; per-IP rate limiting applies. For sustained high-volume or commercial integrations, write to team@pickadive.com.
Example agent guidance (optional)
Add to your AGENTS.md / CLAUDE.md to reduce round-trips:
Support & feedback
- Issues, requests, corrections: team@pickadive.com
- Documentation: pickadive.com/developers
- The dataset behind the tools: pickadive.com/research · pickadive.com/trust
License
MIT — see LICENSE. The PickADive name and logo are trademarks of PickADive and are not covered by the code license.
Disclaimer
Dive conditions are graded forecasts — planning context only, never a safety judgment about any specific dive on any specific day. Always assess conditions at the water, dive within your training, and follow local guidance. Wildlife seasonality reflects recorded sightings, never a promise of encounters.