club-moorage-mcp

MCP server serving yacht-club moorage records — size limits, rafting rules, booking processes, amenities, reciprocal terms, and overnight-comfort ranking. Each record carries a relationship:

• outstation — a facility the club owns for its own members. Ships bundled with the three Royal Victoria Yacht Club (RVYC) outstations (Long Harbour, Friday Harbor, Telegraph Harbour).

• reciprocal — a partner club that hosts visiting RVYC members as guests, with its own visitor terms (free nights, fees, max stay, insurance minimum). Ships bundled with the whole RVYC reciprocal list — 138 clubs, worldwide, in two depths:

  • Researched (confidence med/high, 45 clubs) — the BC + Washington coastal set the boat actually cruises: South Vancouver Island, the Gulf Islands, the Vancouver-side crossing stops, the San Juans / Anacortes / Bellingham, the Strait of Juan de Fuca / North Puget Sound. Per-club terms, fees, size limits and Vaan fit.

  • Listed only (confidence: low, 93 clubs) — everything else on the list: California, Hawaii, Mexico, Bermuda, the Caribbean, eastern Canada, the UK, Australia/NZ and the rest. Position, address, phone and website only, so a passage plan can ask "whose club is in this port?" — guest-moorage terms are not researched and every record says so.

Tools

• list_moorage(clubs?, relationship?) — all moorage: location, coords, size limits.

• find_moorage_near(lat, lon, radius_nm=20, clubs?, relationship?, date?) — nearby moorage, nearest first; annotates live availability when configured.

• get_moorage(name) — full record + prose; for an outstation, also the club's general rules.

• rank_moorage(names, forecast, date?) — overnight-comfort rank for records that support anchoring/mooring; dock-only records are returned under not_ranked. Reuses pilotbook-mcp's scoring against a weather-mcp forecast.

• check_availability(name, date) — live slip availability for RVYC reservable outstations; requires RVYC_USERNAME/RVYC_PASSWORD.

The clubs filter is an optional list of club codes (e.g. ["RVYC"]); omit for all clubs. The relationship filter is "outstation" or "reciprocal"; omit for both. The agent/context layer decides which clubs are relevant from who is aboard. Discontinued reciprocals (available: false) are omitted from list/find but still resolve by name.

Live outstation availability (optional)

check_availability(name, date) reports live slip availability for RVYC's two reservable outstations (Long Harbour, Friday Harbor); find_moorage_near and rank_moorage take an optional date to annotate results the same way. Telegraph Harbour is first-come-first-served (booked via the marina) and reciprocal clubs have no online scheduler, so those return a reason instead of counts.

This layer is off by default. Set RVYC_USERNAME and RVYC_PASSWORD (member credentials) to enable it; without them the tools return static data plus a "not configured" note. No credentials or member data are stored in this package.

Data

Records are markdown (YAML frontmatter + prose) under src/club_moorage_mcp/data/ (clubs/, outstations/, reciprocals/). Point at a different directory with CLUB_MOORAGE_DATA_PATH. pilotbook_anchorage cross-links a record to the nearest pilot-book anchorage; the agent calls pilotbook-mcp's get_anchorage for seabed/depth.

moorage.geojson is a generated map of every bundled record — GitHub renders it inline (blue = outstation, green = reciprocal). Regenerate after a data change with uv run python ingest/build_geojson.py; --check fails on drift, and tests/test_geojson.py does the same in CI.

Reciprocal records are generated from ingest/reciprocals.yaml — edit the YAML, then uv run python ingest/build_records.py. The three RVYC outstations are hand-authored. The club list is the RVYC 2024 Annual; positions and contacts are RVYC's own reciprocal map. Per-club terms were researched from secondary sources where they exist at all; verify fees, LOA, and availability with the club before arrival.

Install

uv sync --dev

Run the server

uv run club-moorage-mcp