Public API

Last updated September 10, 2026.

Nargusta is a sailors' hospitality network. Four read-only endpoints are open to anyone, including software agents acting for a sailor: they let you find members offering hospitality in a port, browse the network, resolve a place name, and look up a yacht club. Everything else in the network, including requesting hospitality, letters of introduction, passages, and vouching, needs an authenticated member and is deliberately not exposed here.

Machine-readable descriptions

OpenAPI 3.1 document, the formal description of the endpoints below.
API catalog, an RFC 9727 linkset.
A2A agent card, describing these capabilities as agent skills.
llms.txt, a plain-language description of the site.

The homepage also returns these as RFC 8288Link headers, so an agent can find all of the above from one request tohttps://nargusta.com/.

MCP server

The same four reads are available over the Model Context Protocol at https://nargusta.com/mcp, so an assistant can query the network directly. It is a stateless Streamable HTTP server: no credential, no session, and the same guest limits as the REST endpoints. Tools aresearch_hosts, browse_hosts, resolve_place andlookup_clubs.

The server card describes it for clients that discover servers automatically. To add it to Claude Code:

claude mcp add --transport http nargusta https://nargusta.com/mcp

Ground rules

Base URL is https://nargusta.com. Every response is JSON.
No credential is required, and none is accepted on these endpoints.
Callers without a member session are limited to 120 reads per IP address per hour. Over the limit you get HTTP 429 and a short error sentence.
Member cards returned to a caller without a session omit reputation: hosting and guest counts and vouch counts read zero, established_host is false, anddistance_km is absent. This is by design, not an error.
Members are never identified by full name or phone number. A card carries a first name and last initial and an opaque id.
This is a non-commercial network of volunteers. Please cache what you fetch, identify your client in a User-Agent, and do not use it to solicit members. The Terms of Use apply to API access as much as to the site.

Hospitality tags

Four tags describe what a member offers. They are the accepted values of the tag parameter.

club-access — Guest access to the member's club
mooring-dock — A guest mooring or dock space
crew-day-sail — A berth as crew, or a day sail
local-hosting — Local hospitality ashore

`GET /api/search`

Hosts near a place or coordinate.

q — Place name to use as the search origin. Required unless lat and lng are given.
lat, lng — Origin coordinate in decimal degrees. Takes precedence over q when both parse.
radius — Radius in statute miles, capped at 1000. Pass any for no limit. Defaults to 50.
tag — Kind of hospitality wanted. Repeat for several.
verifiedOnly — Pass 1 for members with a community-verified club affiliation only.

Returns: An object with origin (null when the place could not be resolved), results (member cards, nearest and best-established first), and clubsHere (club affiliations claimed by the members in results, not necessarily clubs located near the origin).

https://nargusta.com/api/search?q=Newport%2C%20RI&radius=25&tag=mooring-dock

`GET /api/browse`

The whole network, no location.

tag — Kind of hospitality wanted. Repeat for several.
verifiedOnly — Pass 1 for members with a community-verified club affiliation only.

Returns: An array of member cards.

https://nargusta.com/api/browse?tag=club-access

`GET /api/geocode`

A place name resolved to a coordinate.

q — Place name to resolve. Required.

Returns: found, and when found is true, lat, lng, and a canonical label.

https://nargusta.com/api/geocode?q=English%20Harbour%2C%20Antigua

`GET /api/clubs`

Yacht clubs by name or acronym.

q — Partial club name or acronym. An empty query returns an empty array.

Returns: Up to eight clubs, best match first, each with a name, country, and sometimes a region.

https://nargusta.com/api/clubs?q=nyyc

Questions

Reach out through the contact page if you are building something on this and need an endpoint that is not here yet.

Join Nargusta

Phone verified in about a minute. Free and non-commercial.