Skip to main content
Glama

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. 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

TableJSON Schema
NameRequiredDescriptionDefault
property_idYesProperty id or the slug from a booking link.

Output Schema

TableJSON 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. 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"
+]
  2. 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"
+]
  3. 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"
+]
  4. 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"
+]
  5. 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"
+]
  6. 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"
+}
  7. 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"
+}
  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."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"
-}
  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. 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"
+}
  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."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"
-}
  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. 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"
+}
  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."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"
-}
  13. 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."
  14. 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"
+}
  15. 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"
+]
  16. 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"
+]
  17. 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"
+]
  18. 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"
+]
  19. 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"
+}
  20. 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
  21. 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"
+}
  22. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds genuinely non-obvious behavior: location is only neighbourhood-level with the exact address shared after booking, and reviews are a curated 4-/5-star selection with no average rating. These caveats go beyond anything in the structured fields.

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 lead sentence front-loads what is returned, and the remaining sentences each carry distinct semantic content (location granularity, review selection, room-vs-entire-home distinction). It is dense but not padded, though some return-field enumeration is redundant against the existing output schema.

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

Completeness4/5

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

With an output schema present, the return values needn't be enumerated, yet the description supplies the interpretive caveats an agent needs (no average rating, address withheld until booking, what accommodation_type means). Nothing critical for correct invocation appears 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?

Schema description coverage is 100% for the single property_id parameter, and the description adds no format, slug-parsing, or lookup-failure guidance beyond the schema's "Property id or the slug from a booking link." Baseline 3 is correct when the schema already carries the parameter meaning.

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

Purpose4/5

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

The description opens with a specific verb+resource ("Full detail for one property") and enumerates the fields returned, so an agent can tell this apart from search_properties or get_availability without opening a schema. It never names a sibling explicitly, so the differentiation is implied rather than stated.

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

Usage Guidelines3/5

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

Usage is only implied: an agent infers it should call this when it already holds a property_id and needs the full record rather than a search/quote. There is no explicit when-to-use, when-not-to-use, or named alternative (compare_properties, get_live_quote) to route between.

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