Tool tree
Holiday homes, villas and availability search from Birch Stays.
Implementation
gradeNot graded
gradeNot graded
search_propertiesAnswer
Search Birch Stays luxury holiday properties. Filter by location, dates, guests, bedrooms, bathrooms, features, geo radius, and more.
View tool JSON
{
"name": "search_properties",
"kind": "answer",
"impl": "imperative",
"description": "Search Birch Stays luxury holiday properties. Filter by location, dates, guests, bedrooms, bathrooms, features, geo radius, and more.",
"inputSchema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "Free-text area, city, or country"
},
"checkin": {
"type": "string",
"description": "Check-in date YYYY-MM-DD"
},
"checkout": {
"type": "string",
"description": "Check-out date YYYY-MM-DD"
},
"guests": {
"type": "number",
"description": "Minimum guest capacity"
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"pets": {
"type": "number",
"description": "1 to filter dog-friendly only"
},
"sort": {
"type": "string",
"description": "name_asc | name_desc | newest | price_asc | price_desc | bedrooms_asc | bedrooms_desc | guests_asc | guests_desc"
},
"page": {
"type": "number"
},
"limit": {
"type": "number",
"description": "Max 100"
},
"landingPageId": {
"type": "number",
"description": "Scope to a curated landing page"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"radius": {
"type": "number",
"description": "Radius in miles around lat/lng"
},
"features": {
"type": "string",
"description": "Comma-separated feature slugs"
},
"flexDuration": {
"type": "string",
"enum": [
"weekend",
"week",
"month"
]
},
"flexMonth": {
"type": "string",
"description": "YYYY-MM for flexible-date search"
},
"dateFlex": {
"description": "Exact-date flexibility: omit for exact dates; \"any\" for any bookable stay in the range; or 1, 2, 3, 7, 14 to shift the same-length stay"
}
}
}
}get_property_availabilityAnswer
Get blocked, check-in-only, and check-out-only dates for a property, plus the Hostfully booking-window max check-in date.
View tool JSON
{
"name": "get_property_availability",
"kind": "answer",
"impl": "imperative",
"description": "Get blocked, check-in-only, and check-out-only dates for a property, plus the Hostfully booking-window max check-in date.",
"inputSchema": {
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "Hostfully property UID"
}
},
"required": [
"property_uid"
]
}
}get_property_quoteAnswer
Get a full pricing quote for a stay — nightly breakdown, cleaning fee, extras, and total.
View tool JSON
{
"name": "get_property_quote",
"kind": "answer",
"impl": "imperative",
"description": "Get a full pricing quote for a stay — nightly breakdown, cleaning fee, extras, and total.",
"inputSchema": {
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "Hostfully property UID"
},
"checkin": {
"type": "string",
"description": "YYYY-MM-DD"
},
"checkout": {
"type": "string",
"description": "YYYY-MM-DD"
},
"guests": {
"type": "number"
},
"children": {
"type": "number"
},
"pets": {
"type": "number"
}
},
"required": [
"property_uid",
"checkin",
"checkout"
]
}
}autocomplete_locationAction
Suggest up to 5 Birch Stays properties matching a name or area query.
View tool JSON
{
"name": "autocomplete_location",
"kind": "act",
"impl": "imperative",
"description": "Suggest up to 5 Birch Stays properties matching a name or area query.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query (min 2 characters)"
}
},
"required": [
"q"
]
}
}subscribe_newsletterSensitive Action
Subscribe an email address to the Birch Stays newsletter.
View tool JSON
{
"name": "subscribe_newsletter",
"kind": "transact",
"impl": "imperative",
"description": "Subscribe an email address to the Birch Stays newsletter.",
"inputSchema": {
"type": "object",
"properties": {
"email": {
"type": "string"
},
"double_optin": {
"type": "boolean",
"description": "true (default) = confirmation email sent; false = subscribe immediately"
}
},
"required": [
"email"
]
}
}