nausika

developer · docs

Docs.

Last updated

What Nausika is

Nausika is an MCP server that grounds an AI assistant in real maritime data — weather, tides, places, sea routes, geocoding — for recreational navigation in the Mediterranean basin.

The server is hosted at mcp.nausika.app. Sign-in uses OAuth 2.1 via GitHub or Google. The transport is Streamable HTTP per the Model Context Protocol specification.

Connecting the server

Three steps for Claude.ai users:

  • Add https://mcp.nausika.app as a connector in Settings → Connectors.
  • Sign in via GitHub or Google when prompted.
  • The 20 tools become available to your assistant.

Public legal pages: Privacy, Terms, Credits.

Coverage scope

  • The curated dataset is the Mediterranean basin — points of interest, ratings, routes, and contributor data.
  • Forecast, tides, coastline check, and geocoding accept any coordinate and fall back to global third-party sources (Open-Meteo, NOAA, OpenStreetMap) outside the Mediterranean.
  • Place searches outside the Mediterranean typically return empty until contributors expand the atlas.

Tool catalogue

Nausika exposes 20 tools to authenticated users: 9 base (anonymous-safe) and 11 user-scoped (require sign-in).

Base tools (9)

Tool Purpose Scope
nausika_marine_forecast Marine and atmospheric forecast for any coordinate. auth: anonymous
nausika_tides Tide predictions and NOAA station discovery. auth: anonymous
nausika_search_places Proximity, text, and ID search with filters. auth: anonymous
nausika_sea_route Maritime routing on the MARNET graph. auth: anonymous
nausika_geocode Forward and reverse geocoding for places. auth: anonymous
nausika_calculator Offline math evaluator for fuel and distance. auth: anonymous
nausika_describe_place_schema Schema introspection for a given place type. auth: anonymous
nausika_is_water Check whether a coordinate is over water. auth: anonymous
nausika_convert_coordinates Convert between decimal, DMS, and DM formats. auth: anonymous

User-scoped tools (11)

Tool Purpose Scope
nausika_manage_boat_profile Create, update, or delete a boat profile. auth: user
nausika_get_boat_profile Fetch the default or a named boat profile. auth: user
nausika_manage_favorite Add or remove a place from favorites. auth: user
nausika_get_favorites List saved favorite places with notes. auth: user
nausika_manage_rating Rate a place from one to five stars. auth: user
nausika_get_ratings View aggregate or your own place ratings. auth: user
nausika_manage_route Save a single route or a multi-leg itinerary. auth: user
nausika_get_routes List or fetch saved routes by ID. auth: user
nausika_submit_proposal Submit a new place or place-edit proposal. auth: user
nausika_get_proposals List proposal status for the calling user. auth: user
nausika_withdraw_proposal Withdraw a still-pending proposal. auth: user

Domain conventions

  • Distances: nautical miles (nm)
  • Speed: knots (kt)
  • Depths and heights: meters
  • Coordinates: decimal degrees, (latitude, longitude)
  • Defaults: 3-day forecast, 50 km search radius, 6 kt cruising speed

Attribution and provenance

Every tool response includes a machine-readable _attribution array on the structuredContent payload and a human-readable Sources: footer in the text content, so the assistant can surface credit to the end user. Per-source license details are listed at /credits.

Service limits

  • Search radius: max 200 km, default 50 km.
  • Search results: max 100 per call, default 30.
  • Forecast horizon: 16 days on the Forecast endpoint, 8 days on the Marine endpoint; default preset is 3 days.
  • Tide range: configurable; NOAA station distance threshold is around 200 nm before Nausika falls back to Open-Meteo modeled tides.
  • Rate limiting: handled at the platform layer; under sustained load the server returns HTTP 429 with Retry-After. Be polite.

Sample prompts

Five concrete prompts a reviewer can paste verbatim, each followed by the expected tool chain.

  • Passage planning. "Plan a passage from Genoa to Bastia for tomorrow and tell me the conditions." Expected chain: nausika_geocode → nausika_marine_forecast → nausika_sea_route → nausika_calculator.
  • POI search. "Find sheltered anchorages near Portofino with at least three meters of depth." Expected chain: nausika_geocode → nausika_search_places.
  • Tides, US plus Mediterranean. "Compare tomorrow's tides at San Francisco Bay with tides off Cagliari." Expected chain: nausika_geocode → nausika_tides (NOAA path) then nausika_tides (Open-Meteo fallback path for Cagliari).
  • Geocoding outside the Mediterranean. "Where is Lisbon, and is the coordinate over water?" Expected chain: nausika_geocode (falls back to OpenStreetMap Nominatim) → nausika_is_water.
  • Place contribution. "I want to add a small marina I visited in southern Sardinia. What attributes should I provide?" Expected chain: nausika_describe_place_schema → nausika_is_water → nausika_submit_proposal.

Safety

Nausika is an informational copilot. It is not a replacement for certified nautical charts, official Notices to Mariners, or a certified weather briefing. Plan with paper charts on hand and remain responsible for your navigation decisions.

Issues, support, security