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. After displaying cards, default to 1–3 short sentences, usually under 60 words unless the traveler requests a detailed comparison: explain a helpful fit or next choice, and include only a material price/availability caveat or a necessary question. Do not repeat result counts, card facts or the home list unless the traveler asks for a textual comparison. Do not narrate tools called or not called, backend mechanics, or your process. Keep operational checks internal; disclose material uncertainty and pricing assumptions plainly when they affect the traveler’s decision.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>",
      "windowStart": "<windowStart>",
      "windowEnd": "<windowEnd>",
      "nights": "<nights>",
      "guests": "<guests>"
    },
    "name": "get_stay_estimate"
  }
}

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 changedNov 2, 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 30, 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 29, 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: -[
-  {
-    "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": [
-          {
-            "properties": {
-              "breakdown": {
-                "items": {
-                  "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": {
-        "properties": {
-          "averageNightlyPrice": {
-            "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": {
-        "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: +[
+  {
+    "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": [
+          {
+            "properties": {
+              "breakdown": {
+                "items": {
+                  "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": {
+        "properties": {
+          "averageNightlyPrice": {
+            "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": {
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "currency",
+          "amount"
+        ],
+        "type": "object"
+      },
+      "terms": {
+        "properties": {
+          "cancellation": {
+            "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": {
+                  "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": {
+            "properties": {
+              "balanceDue": {
+                "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": {
+                "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": {
+            "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"
+}

Changed5 schema fields changedOct 25, 2026

removedOutput schema / additionalProperties
```
Removed value: -false
```
removedOutput schema / properties / diagnostics / additionalProperties
```
Removed value: -false
```
removedOutput schema / properties / estimate / additionalProperties
```
Removed value: -false
```

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"
-      },
-      "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: +[
+  {
+    "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": [
+          {
+            "properties": {
+              "breakdown": {
+                "items": {
+                  "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": {
+        "properties": {
+          "averageNightlyPrice": {
+            "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": {
+        "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"
+  }
+]

removedOutput schema / properties / request / additionalProperties
```
Removed value: -false
```

Changed3 schema fields changedOct 8, 2026

changedInput schema / properties / currency / enum

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

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

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

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

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

Changed1 schema field changedOct 7, 2026

addedOutput schema / properties / diagnostics

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "attemptedStays": {
+      "maximum": 4,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "reason": {
+      "description": "Last sampled observation when no dated total was selected. Applies only to attempted stays; blocked samples never establish that the whole window is sold out. Terminal unsupported_host/upstream_unavailable evidence should be explained, not retried unchanged.",
+      "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"
+    }
+  },
+  "required": [
+    "attemptedStays"
+  ],
+  "type": "object"
+}

AddedOct 7, 2026

TDQS

A4.5/5.0

Behavior5/5

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

Beyond the annotations, the description discloses important behavior: at most four stays are checked, narrow windows use weekly samples and broad windows try upcoming months, nights/guests/currency stay fixed, quote may be null with unknown availability, and diagnostics retain attempted-stay count and last reason. It also explains that the returned estimate can join a pending sample search and that samples do not prove availability or lowest price.

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 usage constraints are front-loaded, but the description is very long and mixes tool semantics with response-formatting instructions and repeated do-not rules. Much of it is useful for agent behavior, but the density and length make it less concise than ideal.

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?

Given the tool’s complexity, the description is highly complete: it covers call prerequisites, sampling strategy, retry limits, null-quote semantics, diagnostics, pricing caveats, and how the returned estimate is used. The output schema exists, and the description does not need to explain the return shape, but it still clarifies the most decision-relevant output meanings.

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?

The description adds meaning for several inputs, especially flexible windowStart/windowEnd and fixed nights/guests/currency, and warns against substituting a default party. However, schema description coverage is only 38% and the description leaves id, children, and childAges largely unexplained. It also references an optional startingNightlyPrice that is not present in the input schema, which adds confusion.

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?

The description states a specific verb and resource: find a dated price example for a published home with flexible travel dates. It also distinguishes this tool from the sibling alternative by saying explicit travel dates must use get_stay_quote instead.

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?

It gives explicit when-to-use conditions (flexible dates, supplied windowStart/windowEnd, nights and guests) and when-not-to-use guidance (explicit dates go to get_stay_quote). It also names operational alternatives and limits: ask for missing details, do not retry unchanged unsupported hosts, and check at most three shortlisted homes when price is requested.

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.

Resources

Need Help?