chucho — Book Direct

Find a price for flexible dates

get_stay_estimate

Find a dated price example for a published home when travel dates are flexible and the traveler supplied windowStart/windowEnd, nights and guests. Ask for missing details before requesting or showing any price; never substitute a default party or stay. Use the returned stayQuote.estimate to join a pending sample search. Checks at most four stays inside windowStart/windowEnd, through supported public readers only; narrow windows try weekly samples and broad windows try upcoming months. Preserve any requested flexible month or range. Nights, guests and currency stay fixed. Returns the actual selected request and quote; a sample never proves availability for other dates or the lowest price. If no suitable stay is found, quote is null and overall availability is unknown; diagnostics retain the attempted-stay count and last observed reason. Do not retry a completed unsupported host or upstream failure unchanged. When price is requested, finish checks for at most three promising shortlisted homes; do not check every card. Explicit travel dates must use get_stay_quote instead. Optional startingNightlyPrice is an advertised nightly starting rate only, with no confirmed dates, guest basis, fees or taxes; never multiply it into a stay total. No booking, payment or guest contact details.

Input Schema

Name	Required	Description
`id`	Yes
`guests`	Yes
`nights`	Yes
`children`	No	How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet.
`currency`	No	Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing.
`childAges`	No	Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates.
`windowEnd`	Yes
`windowStart`	Yes

Output Schema

Name	Required	Description	Default
`basis`	Yes
`quote`	Yes
`status`	Yes
`request`	Yes
`estimate`	Yes
`diagnostics`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedOct 30, 2026

addedInput schema / properties / currency / description

Added value: +"Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing."

removedInput schema / properties / currency / enum

Removed value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD",
-  "NZD"
-]

addedInput schema / properties / currency / pattern
```
Added value: +"^[A-Z]{3}$"
```

addedOutput schema / properties / estimate / properties / currency / description

Added value: +"Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing."

removedOutput schema / properties / estimate / properties / currency / enum

Removed value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD",
-  "NZD"
-]

addedOutput schema / properties / estimate / properties / currency / pattern
```
Added value: +"^[A-Z]{3}$"
```

addedOutput schema / properties / request / properties / currency / description

Added value: +"Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing."

removedOutput schema / properties / request / properties / currency / enum

Removed value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD",
-  "NZD"
-]

addedOutput schema / properties / request / properties / currency / pattern
```
Added value: +"^[A-Z]{3}$"
```

Changed3 schema fields changedOct 29, 2026

changedInput schema / properties / currency / enum

Previous value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD"
-]New value: +[
+  "USD",
+  "EUR",
+  "GBP",
+  "CRC",
+  "MXN",
+  "COP",
+  "PEN",
+  "BRL",
+  "AUD",
+  "NZD"
+]

changedOutput schema / properties / estimate / properties / currency / enum

Previous value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD"
-]New value: +[
+  "USD",
+  "EUR",
+  "GBP",
+  "CRC",
+  "MXN",
+  "COP",
+  "PEN",
+  "BRL",
+  "AUD",
+  "NZD"
+]

changedOutput schema / properties / request / properties / currency / enum

Previous value: -[
-  "USD",
-  "EUR",
-  "GBP",
-  "CRC",
-  "MXN",
-  "COP",
-  "PEN",
-  "BRL",
-  "AUD"
-]New value: +[
+  "USD",
+  "EUR",
+  "GBP",
+  "CRC",
+  "MXN",
+  "COP",
+  "PEN",
+  "BRL",
+  "AUD",
+  "NZD"
+]

Changed7 schema fields changedOct 28, 2026

addedInput schema / properties / childAges

Added value: +{
+  "description": "Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates.",
+  "items": {
+    "maximum": 17,
+    "minimum": 0,
+    "type": "integer"
+  },
+  "maxItems": 199,
+  "type": "array"
+}

addedInput schema / properties / children

Added value: +{
+  "description": "How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet.",
+  "maximum": 199,
+  "minimum": 1,
+  "type": "integer"
+}

addedOutput schema / properties / estimate / properties / childAges

Added value: +{
+  "description": "Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates.",
+  "items": {
+    "maximum": 17,
+    "minimum": 0,
+    "type": "integer"
+  },
+  "maxItems": 199,
+  "type": "array"
+}

addedOutput schema / properties / estimate / properties / children

Added value: +{
+  "description": "How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet.",
+  "maximum": 199,
+  "minimum": 1,
+  "type": "integer"
+}

changedOutput schema / properties / quote / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "arrival": {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "availability": {
-        "enum": [
-          "available",
-          "unavailable",
-          "unknown"
-        ],
-        "type": "string"
-      },
-      "bookingUrl": {
-        "format": "uri",
-        "type": "string"
-      },
-      "checkedAt": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-        "type": "string"
-      },
-      "departure": {
-        "format": "date",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-        "type": "string"
-      },
-      "expiresAt": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-        "type": "string"
-      },
-      "guests": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "held": {
-        "const": false,
-        "type": "boolean"
-      },
-      "minimumNights": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "nights": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "partyBasis": {
-        "const": "all_adults",
-        "type": "string"
-      },
-      "price": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "breakdown": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "amount": {
-                      "type": "number"
-                    },
-                    "label": {
-                      "maxLength": 160,
-                      "minLength": 1,
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "label",
-                    "amount"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 30,
-                "type": "array"
-              },
-              "completeness": {
-                "enum": [
-                  "total",
-                  "partial"
-                ],
-                "type": "string"
-              },
-              "currency": {
-                "pattern": "^[A-Z]{3}$",
-                "type": "string"
-              },
-              "taxesIncluded": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "total": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "currency",
-              "total",
-              "breakdown",
-              "completeness",
-              "taxesIncluded"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "propertyId": {
-        "type": "string"
-      },
-      "reason": {
-        "enum": [
-          "checked",
-          "blocked_dates",
-          "minimum_stay",
-          "maximum_stay",
-          "arrival_departure_rules",
-          "advance_notice",
-          "capacity",
-          "unsupported_host",
-          "browser_unconfigured",
-          "upstream_unavailable",
-          "date_range_unknown"
-        ],
-        "type": "string"
-      },
-      "roomSelection": {
-        "additionalProperties": false,
-        "properties": {
-          "averageNightlyPrice": {
-            "additionalProperties": false,
-            "properties": {
-              "amount": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "currency": {
-                "pattern": "^[A-Z]{3}$",
-                "type": "string"
-              }
-            },
-            "required": [
-              "currency",
-              "amount"
-            ],
-            "type": "object"
-          },
-          "name": {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          "ratePlan": {
-            "maxLength": 200,
-            "type": "string"
-          },
-          "rooms": {
-            "const": 1,
-            "type": "number"
-          }
-        },
-        "required": [
-          "name",
-          "rooms"
-        ],
-        "type": "object"
-      },
-      "sourceUrl": {
-        "format": "uri",
-        "type": "string"
-      },
-      "startingNightlyPrice": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "currency": {
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "currency",
-          "amount"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "propertyId",
-      "arrival",
-      "departure",
-      "guests",
-      "nights",
-      "availability",
-      "reason",
-      "minimumNights",
-      "price",
-      "checkedAt",
-      "expiresAt",
-      "sourceUrl",
-      "bookingUrl",
-      "held"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "arrival": {
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "availability": {
+        "enum": [
+          "available",
+          "unavailable",
+          "unknown"
+        ],
+        "type": "string"
+      },
+      "bookingUrl": {
+        "format": "uri",
+        "type": "string"
+      },
+      "checkedAt": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+        "type": "string"
+      },
+      "departure": {
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      "expiresAt": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+        "type": "string"
+      },
+      "guests": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "held": {
+        "const": false,
+        "type": "boolean"
+      },
+      "minimumNights": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "nights": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "partyBasis": {
+        "const": "all_adults",
+        "type": "string"
+      },
+      "price": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "breakdown": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "amount": {
+                      "type": "number"
+                    },
+                    "label": {
+                      "maxLength": 160,
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "label",
+                    "amount"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 30,
+                "type": "array"
+              },
+              "completeness": {
+                "enum": [
+                  "total",
+                  "partial"
+                ],
+                "type": "string"
+              },
+              "currency": {
+                "pattern": "^[A-Z]{3}$",
+                "type": "string"
+              },
+              "taxesIncluded": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "total": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "currency",
+              "total",
+              "breakdown",
+              "completeness",
+              "taxesIncluded"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "propertyId": {
+        "type": "string"
+      },
+      "reason": {
+        "enum": [
+          "checked",
+          "blocked_dates",
+          "minimum_stay",
+          "maximum_stay",
+          "arrival_departure_rules",
+          "advance_notice",
+          "capacity",
+          "unsupported_host",
+          "browser_unconfigured",
+          "upstream_unavailable",
+          "date_range_unknown"
+        ],
+        "type": "string"
+      },
+      "roomSelection": {
+        "additionalProperties": false,
+        "properties": {
+          "averageNightlyPrice": {
+            "additionalProperties": false,
+            "properties": {
+              "amount": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "currency": {
+                "pattern": "^[A-Z]{3}$",
+                "type": "string"
+              }
+            },
+            "required": [
+              "currency",
+              "amount"
+            ],
+            "type": "object"
+          },
+          "name": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "ratePlan": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "rooms": {
+            "const": 1,
+            "type": "number"
+          }
+        },
+        "required": [
+          "name",
+          "rooms"
+        ],
+        "type": "object"
+      },
+      "sourceUrl": {
+        "format": "uri",
+        "type": "string"
+      },
+      "startingNightlyPrice": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "currency",
+          "amount"
+        ],
+        "type": "object"
+      },
+      "terms": {
+        "additionalProperties": false,
+        "properties": {
+          "cancellation": {
+            "additionalProperties": false,
+            "properties": {
+              "freeUntil": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                "type": "string"
+              },
+              "nonRefundable": {
+                "type": "boolean"
+              },
+              "policyText": {
+                "maxLength": 2000,
+                "minLength": 1,
+                "type": "string"
+              },
+              "refundWindows": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "format": "date-time",
+                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                      "type": "string"
+                    },
+                    "refundPercent": {
+                      "maximum": 100,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "until": {
+                      "format": "date-time",
+                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "refundPercent"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "payment": {
+            "additionalProperties": false,
+            "properties": {
+              "balanceDue": {
+                "additionalProperties": false,
+                "properties": {
+                  "amount": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "currency": {
+                    "pattern": "^[A-Z]{3}$",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "amount",
+                  "currency"
+                ],
+                "type": "object"
+              },
+              "balanceDueAt": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                "type": "string"
+              },
+              "chargedBy": {
+                "enum": [
+                  "host",
+                  "booking_engine"
+                ],
+                "type": "string"
+              },
+              "depositAmount": {
+                "additionalProperties": false,
+                "properties": {
+                  "amount": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "currency": {
+                    "pattern": "^[A-Z]{3}$",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "amount",
+                  "currency"
+                ],
+                "type": "object"
+              },
+              "depositDueAt": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                "type": "string"
+              },
+              "depositPercent": {
+                "maximum": 100,
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "type": "object"
+          },
+          "provenance": {
+            "additionalProperties": false,
+            "properties": {
+              "fetchedAt": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                "type": "string"
+              },
+              "rawSourceField": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reader": {
+                "maxLength": 100,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "reader",
+              "rawSourceField",
+              "fetchedAt"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "provenance"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "propertyId",
+      "arrival",
+      "departure",
+      "guests",
+      "nights",
+      "availability",
+      "reason",
+      "minimumNights",
+      "price",
+      "checkedAt",
+      "expiresAt",
+      "sourceUrl",
+      "bookingUrl",
+      "held"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / request / properties / childAges

Added value: +{
+  "description": "Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates.",
+  "items": {
+    "maximum": 17,
+    "minimum": 0,
+    "type": "integer"
+  },
+  "maxItems": 199,
+  "type": "array"
+}

addedOutput schema / properties / request / properties / children

Added value: +{
+  "description": "How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet.",
+  "maximum": 199,
+  "minimum": 1,
+  "type": "integer"
+}

First observedOct 22, 2026

TDQS

A4.2/5.0

Behavior4/5

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

Annotations declare readOnlyHint=false, openWorldHint=true, idempotentHint=false and destructiveHint=false, and the description adds real context beyond them: at most four stays checked per call, weekly samples for narrow windows vs upcoming months for broad ones, quote=null with diagnostics when nothing suitable is found, and no booking/payment/guest contact. What is not explained is what the non-read-only behavior actually is (e.g., whether a search is recorded), leaving a small gap against readOnlyHint=false.

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

Conciseness3/5

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

The purpose and the get_stay_quote routing are front-loaded, and several sentences earn their place (null quote semantics, sample-vs-availability caveat, shortlist cap). But it runs well past 200 words with overlapping restatements ('preserve any requested flexible month or range', 'sample never proves availability ... or the lowest price') and an opaque 'do not retry a completed unsupported host or upstream failure unchanged'.

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 and annotations present, the description is nearly complete: it explains how to use stayQuote.estimate, what a null quote means, what diagnostics retain, and that results are samples not availability proofs. The only missing piece is the meaning of the required id/host identifier and how the currency/child inputs interact with the sampled quote.

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 low (38% of 8 params), and only children, childAges and currency carry schema descriptions. The description adds meaning for the window/nights/guests/currency contract ('nights, guests and currency stay fixed') and warns that startingNightlyPrice is an advertised starting rate that must never be multiplied into a stay total. It says nothing about the required id parameter, and startingNightlyPrice is discussed in the description but does not exist in the input schema (additionalProperties=false), which is mildly confusing.

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 (find a dated price example for a published home) plus the exact condition (flexible dates with windowStart/windowEnd, nights, guests). It explicitly names the sibling it is not — 'Explicit travel dates must use get_stay_quote instead' — so an agent can route without opening either schema.

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

Usage Guidelines5/5

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

Gives when-to-use (flexible windows), when-not (explicit dates → get_stay_quote), a prerequisite (ask for missing details; never substitute a default party or stay), and effort bounds (finish checks for at most three shortlisted homes, do not check every card). It also warns against retrying a completed unsupported host or upstream failure unchanged.

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

All chucho — Book Direct tools Inspect

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.