{
  "protocolVersion": "0.3.0",
  "name": "Nargusta Host Discovery",
  "description": "Read-only discovery over the Nargusta sailors' hospitality network: find phone-verified members offering club access, guest moorings and dock space, crew or day sails, and local hosting in a given port, resolve place names to coordinates, and look up yacht clubs by name. Requesting hospitality, letters of introduction, passages, and vouching all require an authenticated member and are not exposed to agents.",
  "version": "1.0.0",
  "url": "https://nargusta.com/api",
  "preferredTransport": "HTTP+JSON",
  "provider": {
    "organization": "Nargusta",
    "url": "https://nargusta.com"
  },
  "documentationUrl": "https://nargusta.com/api-docs",
  "iconUrl": "https://nargusta.com/logo.svg",
  "supportedInterfaces": [
    {
      "url": "https://nargusta.com/api",
      "transport": "HTTP+JSON"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "search-hosts",
      "name": "Search hosts near a place",
      "description": "Given a port, town, or coordinate, return the members offering hospitality nearby, ranked by proximity and standing, with an optional radius in miles and filters for the kind of hospitality offered and for community-verified club affiliations.",
      "tags": [
        "sailing",
        "hospitality",
        "search",
        "geospatial"
      ],
      "examples": [
        "Which Nargusta members can offer a guest mooring near Newport, Rhode Island?",
        "Find members within 25 miles of 41.49,-71.31 who offer crew or a day sail."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "browse-hosts",
      "name": "Browse the network",
      "description": "Return member cards across the whole network with no geographic origin, optionally filtered by the kind of hospitality offered and by community-verified club affiliations.",
      "tags": [
        "sailing",
        "hospitality",
        "browse"
      ],
      "examples": [
        "List Nargusta members who offer club access.",
        "Show every member with a verified club affiliation."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "resolve-place",
      "name": "Resolve a place name",
      "description": "Resolve a typed place name to a latitude and longitude with a canonical label, so a caller can confirm where a place plots before searching on it.",
      "tags": [
        "geocoding",
        "geospatial"
      ],
      "examples": [
        "Where does English Harbour, Antigua plot?",
        "Get coordinates for Port Townsend, Washington."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lookup-clubs",
      "name": "Look up yacht clubs",
      "description": "Fuzzy lookup over the yacht and sailing club directory by name, acronym, or partial spelling, returning up to eight clubs with country and region.",
      "tags": [
        "yacht-clubs",
        "reference"
      ],
      "examples": [
        "What club does the acronym NYYC stand for?",
        "Find sailing clubs whose name contains Royal."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}