discover_destinations_near

unverifiedv0.1

Curated destinations — cities, neighborhoods, airports, points of interest — within a radius of a geographic point, for use as a `destination_id` in subsequent `search_stays` calls. Useful when coordinates are already in hand (from world knowledge, from a previous tool result, or directly from the user) and the agent needs to enumerate which curated destinations cover that area before searching for properties. Also useful as a fan-out entry point for region-level intents — broad areas such as 'Tuscany', 'Pacific Northwest', 'New England', or 'Central Europe' — where the agent can pass an approximate regional centroid and surface a list of sub-destinations the user may then narrow down to before a focused search. Returns up to 5 candidates ordered by distance. The radius defaults to 5 km; widens up to 50 km for broader queries.

Updated 9/25/2026 · Created 9/25/2026

Input Schema

{
  "type": "object",
  "required": [
    "lat",
    "lon"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude of the centre point, decimal degrees (WGS84). Typically the coordinates of a city or region already known from world knowledge or from an earlier resolve_destination call."
    },
    "lon": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude of the centre point, decimal degrees (WGS84). Negative west of Greenwich."
    },
    "type": {
      "enum": [
        "city",
        "neighborhood",
        "airport",
        "poi"
      ],
      "type": "string",
      "description": "Optional filter; same semantics as resolve_destination."
    },
    "language": {
      "enum": [
        "en",
        "it",
        "fr",
        "de",
        "es",
        "pt",
        "nl",
        "ko",
        "pl",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the returned destination names (2-letter lowercase). Pass the language the user is speaking; defaults to 'en'."
    },
    "radius_km": {
      "type": "number",
      "default": 5,
      "maximum": 50,
      "minimum": 0.1,
      "description": "Search radius in km from the point. Defaults to 5 km (city-center scope)."
    }
  }
}

Full Contract

{
  "name": "discover_destinations_near",
  "description": "Curated destinations — cities, neighborhoods, airports, points of interest — within a radius of a geographic point, for use as a `destination_id` in subsequent `search_stays` calls. Useful when coordinates are already in hand (from world knowledge, from a previous tool result, or directly from the user) and the agent needs to enumerate which curated destinations cover that area before searching for properties.\n\nAlso useful as a fan-out entry point for region-level intents — broad areas such as 'Tuscany', 'Pacific Northwest', 'New England', or 'Central Europe' — where the agent can pass an approximate regional centroid and surface a list of sub-destinations the user may then narrow down to before a focused search.\n\nReturns up to 5 candidates ordered by distance. The radius defaults to 5 km; widens up to 50 km for broader queries.",
  "inputSchema": {
    "type": "object",
    "required": [
      "lat",
      "lon"
    ],
    "properties": {
      "lat": {
        "type": "number",
        "maximum": 90,
        "minimum": -90,
        "description": "Latitude of the centre point, decimal degrees (WGS84). Typically the coordinates of a city or region already known from world knowledge or from an earlier resolve_destination call."
      },
      "lon": {
        "type": "number",
        "maximum": 180,
        "minimum": -180,
        "description": "Longitude of the centre point, decimal degrees (WGS84). Negative west of Greenwich."
      },
      "type": {
        "enum": [
          "city",
          "neighborhood",
          "airport",
          "poi"
        ],
        "type": "string",
        "description": "Optional filter; same semantics as resolve_destination."
      },
      "language": {
        "enum": [
          "en",
          "it",
          "fr",
          "de",
          "es",
          "pt",
          "nl",
          "ko",
          "pl",
          "ja"
        ],
        "type": "string",
        "default": "en",
        "description": "Language of the returned destination names (2-letter lowercase). Pass the language the user is speaking; defaults to 'en'."
      },
      "radius_km": {
        "type": "number",
        "default": 5,
        "maximum": 50,
        "minimum": 0.1,
        "description": "Search radius in km from the point. Defaults to 5 km (city-center scope)."
      }
    }
  }
}

GET /api/tool/b2a.bluepillow.com/webmcp/discover_destinations_near