registry

Search vacation rental properties in the Caribbean. YOU ARE THE BUYER'S AGENT — search on behalf of your human. After searching, create a session (rental_session_create) and add your best picks (rental_session_add). Share the bridge URL with your human.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country code: KY (Cayman Islands) or LC (St. Lucia)"
    },
    "island": {
      "type": "string",
      "description": "Island name: Grand Cayman, Cayman Brac, Little Cayman, St. Lucia"
    },
    "region": {
      "type": "string",
      "description": "Region: Seven Mile Beach, North Side, Rum Point, West Bay, Soufriere, Rodney Bay, etc."
    },
    "bedrooms": {
      "type": "integer",
      "description": "Minimum bedrooms"
    },
    "sleeps": {
      "type": "integer",
      "description": "Minimum guests the property sleeps"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum nightly rate in USD"
    },
    "min_price": {
      "type": "number",
      "description": "Minimum nightly rate in USD"
    },
    "property_type": {
      "type": "string",
      "enum": [
        "villa",
        "condo",
        "apartment",
        "house",
        "guest_house"
      ]
    },
    "amenity": {
      "type": "string",
      "description": "Required amenity: pool, beach_access, ocean_view, wifi, kitchen, ac, parking"
    },
    "q": {
      "type": "string",
      "description": "Free text search across name, description, region"
    },
    "limit": {
      "type": "integer",
      "description": "Results per page (default 20, max 50)"
    }
  }
}

Get full details for a rental property by its RIN (Rental Identification Number). Returns property info, all platform listings, reviews, license status, and price history.

{
  "type": "object",
  "properties": {
    "rin": {
      "type": "string",
      "description": "Rental Identification Number (e.g., RIN-abc123def456)"
    }
  },
  "required": [
    "rin"
  ]
}

Check availability for a rental property on specific dates.

{
  "type": "object",
  "properties": {
    "rin": {
      "type": "string",
      "description": "Rental Identification Number"
    },
    "check_in": {
      "type": "string",
      "description": "Check-in date (YYYY-MM-DD)"
    },
    "check_out": {
      "type": "string",
      "description": "Check-out date (YYYY-MM-DD)"
    }
  },
  "required": [
    "rin"
  ]
}

Get market intelligence for Caribbean rental markets: average rates, occupancy estimates, property counts, seasonal patterns.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country code: KY or LC"
    },
    "island": {
      "type": "string",
      "description": "Island name"
    }
  }
}

Compare pricing for the same property across different platforms (Airbnb, VRBO, local agencies, direct booking). Shows rate spread and savings.

{
  "type": "object",
  "properties": {
    "rin": {
      "type": "string",
      "description": "Rental Identification Number"
    }
  },
  "required": [
    "rin"
  ]
}

View nightly rate history for a property over time.

{
  "type": "object",
  "properties": {
    "rin": {
      "type": "string",
      "description": "Rental Identification Number"
    }
  },
  "required": [
    "rin"
  ]
}

Get aggregated review data for a property across all platforms.

{
  "type": "object",
  "properties": {
    "rin": {
      "type": "string",
      "description": "Rental Identification Number"
    }
  },
  "required": [
    "rin"
  ]
}

Look up government tourism accommodation license for a property. In Cayman Islands, unlicensed operation carries $100,000/day fine.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "License number, property name, or address to search"
    }
  },
  "required": [
    "query"
  ]
}

View all tracked data sources with AI-readability assessment. Shows which rental sites AI can read, which are partially readable, and which block AI entirely.

{
  "type": "object",
  "properties": {}
}

Get database statistics: total properties, by country, by island, platform coverage, source counts.

{
  "type": "object",
  "properties": {}
}

Get orientation context. READ THIS FIRST. You are the buyer's agent. The workflow is: (1) rental_search, (2) rental_session_create, (3) rental_session_add your picks, (4) share the bridge URL with your human.

{
  "type": "object",
  "properties": {}
}

IMPORTANT: Create this FIRST when helping someone find a rental. Returns a shareable URL (bridge page) where your recommendations appear. Your human opens this page to see your curated picks, photos, pricing, and inquiry buttons. After creating, add properties with rental_session_add, then SHARE THE URL with your human.

{
  "type": "object",
  "properties": {
    "destination_country": {
      "type": "string",
      "description": "KY or LC"
    },
    "destination_island": {
      "type": "string"
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "guests": {
      "type": "integer"
    },
    "bedrooms_min": {
      "type": "integer"
    },
    "budget_max": {
      "type": "number",
      "description": "Max nightly rate USD"
    },
    "preferences": {
      "type": "string",
      "description": "Free text: beachfront, pool, quiet, family-friendly, etc."
    },
    "agent_id": {
      "type": "string",
      "description": "Your agent identifier (claude, gpt, grok, etc.)"
    }
  }
}

Add a property to your human's bridge page. Include a score (1-10) and explain WHY this property fits their needs. You are their buyer's agent — only recommend properties you believe match. The human sees your score and notes on their page.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "Session hash"
    },
    "rin": {
      "type": "string",
      "description": "Property RIN to add"
    },
    "score": {
      "type": "integer",
      "description": "Fit score 1-10"
    },
    "notes": {
      "type": "string",
      "description": "Why this property matches"
    },
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "session",
    "rin"
  ]
}

Read a bridge session: see all added properties, messages, and status.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "Session hash"
    },
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "session"
  ]
}

Search Turks & Caicos rentals and island venues (restaurants, dive shops, marinas, attractions) by keyword. Returns results with id, title, and url. Then call fetch with an id for full detail.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. \"beachfront villa\", \"dive shop\", \"italian restaurant near Grace Bay\""
    }
  },
  "required": [
    "query"
  ]
}

Fetch the full record for an id returned by search — a rental property (by RIN) or an island venue.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id from a search result (a RIN or a venue id)"
    }
  },
  "required": [
    "id"
  ]
}