nausika

connect · 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, and 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.

Connect in three steps

Five minutes inside Claude.ai. No API keys, no SDK. A longer walkthrough with a copy-to-clipboard URL lives on the homepage.

  1. Open the connector dialog

    From your profile menu in Claude.ai, go to Customize → Connectors and click Add custom connector.

    Stylized, not a screenshot. Or use the direct link to skip straight to the modal.

  2. Add Nausika and authenticate

    Set a display name and paste https://mcp.nausika.app as the remote MCP server URL. Click Add, then Connect to run the OAuth handshake with GitHub or Google.

  3. Turn it on in a chat and ask

    In any chat, open the + menu, choose Connectors, toggle Nausika on, and ask something concrete. Nausika's tools are invoked automatically when the question is maritime.

Verify the integration

Five prompts a sailor can paste verbatim. Each card shows the tool chain Nausika expects the assistant to walk.

Passage planning

Plan a passage from Genoa to Bastia for tomorrow and tell me the conditions.

nausika_geocode nausika_marine_forecast nausika_sea_route nausika_calculator

POI search

Find sheltered anchorages near Portofino with at least three meters of depth.

nausika_geocode nausika_search_places

Tides, US and Mediterranean

Compare tomorrow's tides at San Francisco Bay with tides off Cagliari.

NOAA station path for San Francisco Bay; Open-Meteo fallback for Cagliari.

nausika_geocode nausika_tides

Geocoding outside the Mediterranean

Where is Lisbon, and is the coordinate over water?

Geocode falls back to OpenStreetMap Nominatim outside the curated atlas.

nausika_geocode nausika_is_water

Place contribution

I want to add a small marina I visited in southern Sardinia. What attributes should I provide?

nausika_describe_place_schema nausika_is_water nausika_submit_proposal

Tool catalogue

Twenty tools to authenticated users: 9 anonymous-safe and 11 that require sign-in. Schema names are canonical; pass them verbatim from any client.

Base tools· 09 auth: anonymous
  1. nausika_marine_forecast Marine and atmospheric forecast for any coordinate.
  2. nausika_tides Tide predictions and NOAA station discovery.
  3. nausika_search_places Proximity, text, and ID search with filters.
  4. nausika_sea_route Maritime routing on the MARNET graph.
  5. nausika_geocode Forward and reverse geocoding for places.
  6. nausika_calculator Offline math evaluator for fuel and distance.
  7. nausika_describe_place_schema Schema introspection for a given place type.
  8. nausika_is_water Check whether a coordinate is over water.
  9. nausika_convert_coordinates Convert between decimal, DMS, and DM formats.
User-scoped· 11 auth: signed-in user
  1. nausika_manage_boat_profile Create, update, or delete a boat profile.
  2. nausika_get_boat_profile Fetch the default or a named boat profile.
  3. nausika_manage_favorite Add or remove a place from favorites.
  4. nausika_get_favorites List saved favorite places with notes.
  5. nausika_manage_rating Rate a place from one to five stars.
  6. nausika_get_ratings View aggregate or your own place ratings.
  7. nausika_manage_route Save a single route or a multi-leg itinerary.
  8. nausika_get_routes List or fetch saved routes by ID.
  9. nausika_submit_proposal Submit a new place or place-edit proposal.
  10. nausika_get_proposals List proposal status for the calling user.
  11. nausika_withdraw_proposal Withdraw a still-pending proposal.

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.

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

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.

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.

Issues, support, security