Skip to main content
Glama
Sign In

EscapeStays by Luxury Lodging

by com.luxurylodgingpm.stay
OverviewDiscussionsAdmin

Get property details

get_property_details
Read-onlyIdempotent

Full detail for one property: bedrooms, capacity, amenities recorded by the property manager, photos, house rules and the real check-in, check-out, deposit and pet policies for that specific home. policies.minimum_nights is the general policy baseline; calendar restrictions can require more on particular dates. Dated availability reports calendar rules, and an exact quote checks whether a specific stay meets them. Location is given at neighbourhood level; the exact address is shared after booking. Guest reviews are a selection of 4- and 5-star reviews, each with its source; no average rating exists. accommodation_type and bathroom_sharing say whether the guest rents an entire home or a room: a private room or shared room is not an entire home.

Input Schema

NameRequiredDescriptionDefault
property_idYesProperty id or the slug from a booking link.

Output Schema

NameRequiredDescriptionDefault
bedsNo
nameYes
aliasNo
photosYes
sleepsNo
bedroomsNo
locationYes
policiesYesThis home's own policies, not portfolio defaults, when policies_source is "provider".
amenitiesYes
bathroomsNo
booking_urlYes
descriptionNo
house_rulesYes
property_idYes
guest_reviewsYesA selection of 4- and 5-star reviews, not a summary of every review. No overall or average rating is implied or available.
property_typeNo
support_emailYes
amenities_sourceYes
bathroom_sharingNoWhether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.
common_questionsNo
accommodation_typeNoWhat the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / policies / properties / minimum_nights / description
      Added value: +"The general minimum from this home's policy source. It is a baseline, not a promise that every date allows a stay this short; date-specific calendar rules can be higher. An exact quote checks the requested dates."
  2. Changed5 schema fields changed
    • addedOutput schema / properties / accommodation_type
      Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / bathroom_sharing
      Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / enum
      Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]
  3. Changed5 schema fields changed
    • removedOutput schema / properties / accommodation_type
      Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / bathroom_sharing
      Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."New value: +"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / enum
      Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]
  4. Changed5 schema fields changed
    • addedOutput schema / properties / accommodation_type
      Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / bathroom_sharing
      Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / enum
      Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]
  5. Changed5 schema fields changed
    • removedOutput schema / properties / accommodation_type
      Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / bathroom_sharing
      Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."New value: +"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / enum
      Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]
  6. Changed3 schema fields changed
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / enum
      Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]
  7. Changed2 schema fields changed
    • addedOutput schema / properties / accommodation_type
      Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / bathroom_sharing
      Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}
  8. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on. Always name it when quoting the review."New value: +"The platform the review was left on."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; never assume one."New value: +"Null when the provider gave none; the country is then unknown."
    • addedOutput schema / properties / policies / properties / pet_fee / description
      Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • addedOutput schema / properties / policies / properties / pet_fee_basis
      Added value: +{
+  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pet_fee_note
      Added value: +{
+  "type": "string"
+}
  9. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on."New value: +"The platform the review was left on. Always name it when quoting the review."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; the country is then unknown."New value: +"Null when the provider gave none; never assume one."
    • removedOutput schema / properties / policies / properties / pet_fee / description
      Removed value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • removedOutput schema / properties / policies / properties / pet_fee_basis
      Removed value: -{
-  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
-  "enum": [
-    "per stay",
-    "per pet",
-    "per pet per night"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / policies / properties / pet_fee_note
      Removed value: -{
-  "type": "string"
-}
  10. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on. Always name it when quoting the review."New value: +"The platform the review was left on."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; never assume one."New value: +"Null when the provider gave none; the country is then unknown."
    • addedOutput schema / properties / policies / properties / pet_fee / description
      Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • addedOutput schema / properties / policies / properties / pet_fee_basis
      Added value: +{
+  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pet_fee_note
      Added value: +{
+  "type": "string"
+}
  11. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on."New value: +"The platform the review was left on. Always name it when quoting the review."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; the country is then unknown."New value: +"Null when the provider gave none; never assume one."
    • removedOutput schema / properties / policies / properties / pet_fee / description
      Removed value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • removedOutput schema / properties / policies / properties / pet_fee_basis
      Removed value: -{
-  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
-  "enum": [
-    "per stay",
-    "per pet",
-    "per pet per night"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / policies / properties / pet_fee_note
      Removed value: -{
-  "type": "string"
-}
  12. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on. Always name it when quoting the review."New value: +"The platform the review was left on."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; never assume one."New value: +"Null when the provider gave none; the country is then unknown."
    • addedOutput schema / properties / policies / properties / pet_fee / description
      Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • addedOutput schema / properties / policies / properties / pet_fee_basis
      Added value: +{
+  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pet_fee_note
      Added value: +{
+  "type": "string"
+}
  13. Changed5 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on."New value: +"The platform the review was left on. Always name it when quoting the review."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; the country is then unknown."New value: +"Null when the provider gave none; never assume one."
    • removedOutput schema / properties / policies / properties / pet_fee / description
      Removed value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • removedOutput schema / properties / policies / properties / pet_fee_basis
      Removed value: -{
-  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
-  "enum": [
-    "per stay",
-    "per pet",
-    "per pet per night"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / policies / properties / pet_fee_note
      Removed value: -{
-  "type": "string"
-}
  14. Changed4 schema fields changed
    • changedOutput schema / properties / guest_reviews / properties / reviews / items / properties / source / description
      Previous value: -"The platform the review was left on. Always name it when quoting the review."New value: +"The platform the review was left on."
    • changedOutput schema / properties / location / properties / country / description
      Previous value: -"Null when the provider gave none; never assume one."New value: +"Null when the provider gave none; the country is then unknown."
    • changedOutput schema / properties / policies / properties / pet_fee / description
      Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified (read pet_fee_note)."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."
    • changedOutput schema / properties / policies / properties / pet_fee_basis / description
      Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights; get_live_quote states the stay's amount."New value: +"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."
  15. Changed3 schema fields changed
    • addedOutput schema / properties / policies / properties / pet_fee / description
      Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified (read pet_fee_note)."
    • addedOutput schema / properties / policies / properties / pet_fee_basis
      Added value: +{
+  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights; get_live_quote states the stay's amount.",
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pet_fee_note
      Added value: +{
+  "type": "string"
+}
  16. Changed2 schema fields changed
    • addedOutput schema / properties / location / properties / country / description
      Added value: +"Null when the provider gave none; never assume one."
    • changedOutput schema / properties / location / properties / country / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
  17. Changed3 schema fields changed
    • addedOutput schema / properties / policies / properties / pet_policy_note
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pets_allowed / description
      Added value: +"Omitted when pet policy could not be verified."
    • changedOutput schema / properties / policies / required
      Previous value: -[
-  "check_in_from",
-  "check_out_by",
-  "cancellation",
-  "security_deposit_hold",
-  "pets_allowed",
-  "policies_source"
-]New value: +[
+  "check_in_from",
+  "check_out_by",
+  "cancellation",
+  "security_deposit_hold",
+  "policies_source"
+]
  18. Changed3 schema fields changed
    • removedOutput schema / properties / policies / properties / pet_policy_note
      Removed value: -{
-  "type": "string"
-}
    • removedOutput schema / properties / policies / properties / pets_allowed / description
      Removed value: -"Omitted when pet policy could not be verified."
    • changedOutput schema / properties / policies / required
      Previous value: -[
-  "check_in_from",
-  "check_out_by",
-  "cancellation",
-  "security_deposit_hold",
-  "policies_source"
-]New value: +[
+  "check_in_from",
+  "check_out_by",
+  "cancellation",
+  "security_deposit_hold",
+  "pets_allowed",
+  "policies_source"
+]
  19. Changed3 schema fields changed
    • addedOutput schema / properties / policies / properties / pet_policy_note
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / policies / properties / pets_allowed / description
      Added value: +"Omitted when pet policy could not be verified."
    • changedOutput schema / properties / policies / required
      Previous value: -[
-  "check_in_from",
-  "check_out_by",
-  "cancellation",
-  "security_deposit_hold",
-  "pets_allowed",
-  "policies_source"
-]New value: +[
+  "check_in_from",
+  "check_out_by",
+  "cancellation",
+  "security_deposit_hold",
+  "policies_source"
+]
  20. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "alias": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "amenities": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "amenities_source": {
+      "enum": [
+        "provider",
+        "unavailable"
+      ],
+      "type": "string"
+    },
+    "bathrooms": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "bedrooms": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "beds": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "booking_url": {
+      "type": "string"
+    },
+    "common_questions": {
+      "items": {
+        "properties": {
+          "answer": {
+            "type": "string"
+          },
+          "question": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "question",
+          "answer"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "description": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "guest_reviews": {
+      "description": "A selection of 4- and 5-star reviews, not a summary of every review. No overall or average rating is implied or available.",
+      "properties": {
+        "reviews": {
+          "items": {
+            "properties": {
+              "published": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "description": "The platform the review was left on. Always name it when quoting the review.",
+                "type": "string"
+              },
+              "stars": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "text": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "source"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "selection": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "selection",
+        "reviews"
+      ],
+      "type": "object"
+    },
+    "house_rules": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "location": {
+      "properties": {
+        "city": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "neighbourhood": {
+          "description": "Neighbourhood-level location only; the exact address is shared after booking.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "state": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "city",
+        "country"
+      ],
+      "type": "object"
+    },
+    "name": {
+      "type": "string"
+    },
+    "photos": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "policies": {
+      "description": "This home's own policies, not portfolio defaults, when policies_source is \"provider\".",
+      "properties": {
+        "cancellation": {
+          "type": "string"
+        },
+        "check_in_from": {
+          "type": "string"
+        },
+        "check_in_until": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "check_out_by": {
+          "type": "string"
+        },
+        "minimum_nights": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pet_fee": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pets_allowed": {
+          "type": "boolean"
+        },
+        "policies_source": {
+          "enum": [
+            "provider",
+            "portfolio-default"
+          ],
+          "type": "string"
+        },
+        "quiet_hours": {
+          "properties": {
+            "from": {
+              "type": "string"
+            },
+            "to": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "from",
+            "to"
+          ],
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "security_deposit_hold": {
+          "description": "A refundable hold, not part of the total charged at booking.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "check_in_from",
+        "check_out_by",
+        "cancellation",
+        "security_deposit_hold",
+        "pets_allowed",
+        "policies_source"
+      ],
+      "type": "object"
+    },
+    "property_id": {
+      "type": "integer"
+    },
+    "property_type": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "sleeps": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "support_email": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "property_id",
+    "name",
+    "location",
+    "amenities",
+    "amenities_source",
+    "photos",
+    "policies",
+    "house_rules",
+    "guest_reviews",
+    "booking_url",
+    "support_email"
+  ],
+  "type": "object"
+}
  21. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
-  "properties": {
-    "alias": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "amenities": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "amenities_source": {
-      "enum": [
-        "provider",
-        "unavailable"
-      ],
-      "type": "string"
-    },
-    "bathrooms": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "bedrooms": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "beds": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "booking_url": {
-      "type": "string"
-    },
-    "common_questions": {
-      "items": {
-        "properties": {
-          "answer": {
-            "type": "string"
-          },
-          "question": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "question",
-          "answer"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "description": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "guest_reviews": {
-      "description": "A selection of 4- and 5-star reviews, not a summary of every review. No overall or average rating is implied or available.",
-      "properties": {
-        "reviews": {
-          "items": {
-            "properties": {
-              "published": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source": {
-                "description": "The platform the review was left on. Always name it when quoting the review.",
-                "type": "string"
-              },
-              "stars": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "text": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "source"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "selection": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "selection",
-        "reviews"
-      ],
-      "type": "object"
-    },
-    "house_rules": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "location": {
-      "properties": {
-        "city": {
-          "type": "string"
-        },
-        "country": {
-          "type": "string"
-        },
-        "neighbourhood": {
-          "description": "Neighbourhood-level location only; the exact address is shared after booking.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "state": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "city",
-        "country"
-      ],
-      "type": "object"
-    },
-    "name": {
-      "type": "string"
-    },
-    "photos": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "policies": {
-      "description": "This home's own policies, not portfolio defaults, when policies_source is \"provider\".",
-      "properties": {
-        "cancellation": {
-          "type": "string"
-        },
-        "check_in_from": {
-          "type": "string"
-        },
-        "check_in_until": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "check_out_by": {
-          "type": "string"
-        },
-        "minimum_nights": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "pet_fee": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "pets_allowed": {
-          "type": "boolean"
-        },
-        "policies_source": {
-          "enum": [
-            "provider",
-            "portfolio-default"
-          ],
-          "type": "string"
-        },
-        "quiet_hours": {
-          "properties": {
-            "from": {
-              "type": "string"
-            },
-            "to": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "from",
-            "to"
-          ],
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "security_deposit_hold": {
-          "description": "A refundable hold, not part of the total charged at booking.",
-          "type": "number"
-        }
-      },
-      "required": [
-        "check_in_from",
-        "check_out_by",
-        "cancellation",
-        "security_deposit_hold",
-        "pets_allowed",
-        "policies_source"
-      ],
-      "type": "object"
-    },
-    "property_id": {
-      "type": "integer"
-    },
-    "property_type": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "sleeps": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "support_email": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "property_id",
-    "name",
-    "location",
-    "amenities",
-    "amenities_source",
-    "photos",
-    "policies",
-    "house_rules",
-    "guest_reviews",
-    "booking_url",
-    "support_email"
-  ],
-  "type": "object"
-}New value: +null
  22. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "alias": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "amenities": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "amenities_source": {
+      "enum": [
+        "provider",
+        "unavailable"
+      ],
+      "type": "string"
+    },
+    "bathrooms": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "bedrooms": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "beds": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "booking_url": {
+      "type": "string"
+    },
+    "common_questions": {
+      "items": {
+        "properties": {
+          "answer": {
+            "type": "string"
+          },
+          "question": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "question",
+          "answer"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "description": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "guest_reviews": {
+      "description": "A selection of 4- and 5-star reviews, not a summary of every review. No overall or average rating is implied or available.",
+      "properties": {
+        "reviews": {
+          "items": {
+            "properties": {
+              "published": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "description": "The platform the review was left on. Always name it when quoting the review.",
+                "type": "string"
+              },
+              "stars": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "text": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "source"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "selection": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "selection",
+        "reviews"
+      ],
+      "type": "object"
+    },
+    "house_rules": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "location": {
+      "properties": {
+        "city": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "neighbourhood": {
+          "description": "Neighbourhood-level location only; the exact address is shared after booking.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "state": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "city",
+        "country"
+      ],
+      "type": "object"
+    },
+    "name": {
+      "type": "string"
+    },
+    "photos": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "policies": {
+      "description": "This home's own policies, not portfolio defaults, when policies_source is \"provider\".",
+      "properties": {
+        "cancellation": {
+          "type": "string"
+        },
+        "check_in_from": {
+          "type": "string"
+        },
+        "check_in_until": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "check_out_by": {
+          "type": "string"
+        },
+        "minimum_nights": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pet_fee": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pets_allowed": {
+          "type": "boolean"
+        },
+        "policies_source": {
+          "enum": [
+            "provider",
+            "portfolio-default"
+          ],
+          "type": "string"
+        },
+        "quiet_hours": {
+          "properties": {
+            "from": {
+              "type": "string"
+            },
+            "to": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "from",
+            "to"
+          ],
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "security_deposit_hold": {
+          "description": "A refundable hold, not part of the total charged at booking.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "check_in_from",
+        "check_out_by",
+        "cancellation",
+        "security_deposit_hold",
+        "pets_allowed",
+        "policies_source"
+      ],
+      "type": "object"
+    },
+    "property_id": {
+      "type": "integer"
+    },
+    "property_type": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "sleeps": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "support_email": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "property_id",
+    "name",
+    "location",
+    "amenities",
+    "amenities_source",
+    "photos",
+    "policies",
+    "house_rules",
+    "guest_reviews",
+    "booking_url",
+    "support_email"
+  ],
+  "type": "object"
+}
  23. First observed

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, open-world, non-destructive, so the safety profile is covered. The description adds genuinely non-obvious behavioral context: location is neighbourhood-level with the exact address only after booking, reviews are a 4- and 5-star selection with no average rating, and minimum_nights is only a baseline that calendar rules can override.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first clause, and each following sentence carries distinct, non-redundant information about data shape and policy semantics. It is information-dense but slightly long, with several caveats packed into one paragraph.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be re-explained; the description instead covers the non-obvious semantics an agent cannot infer (neighbourhood-level location, review selection, policy baselines, entire-home vs room distinction). Nothing needed to call and interpret this tool is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is a single parameter with 100% schema description coverage, so the schema already explains that property_id accepts an id or a booking-link slug. The description adds no further parameter meaning, which is the expected baseline of 3 when the schema does the work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (full detail for one property) and enumerates the concrete content: bedrooms, capacity, amenities, photos, house rules, and real check-in/check-out/deposit/pet policies. It also distinguishes itself from date-scoped siblings by noting that minimum_nights is only a baseline and that availability/quote tools handle specific dates.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear context for when this tool applies and points at adjacent flows ('dated availability reports calendar rules, and an exact quote checks whether a specific stay meets them'), effectively routing to get_availability and get_live_quote. However, it never names those tools or states an explicit exclusion, leaving some inference to the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All EscapeStays by Luxury Lodging toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources