Servidor MCP

Threshold

rentals.threshold/stays
Viajes y hospitalidad Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches, quotes, books, manages, and communicates about verified independent vacation rental stays.

ask_host
Ask the host a question
Send a question the property record and FAQ don't answer. The answer arrives later; tell the guest you'll follow up. Don't include the guest's contact details. Maps to POST /v1/properties/{id}/questions.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['property_id', 'question'], 'properties': {'question': {'type': 'string', 'maxLength': 500}, 'property_id': {'type': 'string'}}}
cancel_booking
Cancel a booking or request
Two-step. First call with confirm=false to see what the guest gets back if they cancel now (nothing changes). Tell the guest that refund and get their go-ahead, then call again with confirm=true and expected_refund_cents set to the refund amount from the first call. If the refund changed in between, the call fails with refund_changed instead of cancelling. Refunds go to the guest's card automatically. Pass guest_email (the email the booking was made with) unless you connect with an agent token.
Destructivo Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['booking_id', 'confirm'], 'properties': {'confirm': {'type': 'boolean'}, 'booking_id': {'type': 'string'}, 'guest_email': {'type': 'string', 'format': 'email'}, 'expected_refund_cents': {'type': 'integer', 'description': 'Required when confirm is true: refund.amount from the confirm=false call.'}}}
check_availability
Check a property's calendar
Day-by-day availability and indicative nightly prices for up to 180 days. Cached; use get_quote to confirm. Useful when the guest's dates are flexible. Maps to GET /v1/properties/{id}/availability.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['property_id', 'from', 'to'], 'properties': {'to': {'type': 'string', 'format': 'date', 'description': 'Exclusive'}, 'from': {'type': 'string', 'format': 'date'}, 'property_id': {'type': 'string'}}}
get_booking
Get booking status
Status, amounts, refund schedule, guest ID verification link, and when arrival details will be sent. Maps to GET /v1/bookings/{id}.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'string'}}}
get_messages
Read messages with the host
The conversation between the guest and the host about a booking, oldest first (including the guest's note with the request and the host's note when accepting or declining). Use it to relay the host's replies. Pass guest_email (the email the booking was made with) unless you connect with an agent token.
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'string'}, 'guest_email': {'type': 'string', 'format': 'email'}}}
get_property
Get property details
Full record for one property: beds by room, amenities with details, access and stairs, rules, host FAQ, policies, and verification status. Maps to GET /v1/properties/{id}.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['property_id'], 'properties': {'property_id': {'type': 'string'}}}
get_quote
Get a binding price
Itemized, binding price for exact dates and party, after re-checking the host's live calendars. Valid 10 minutes. Returns house rules and an exact refund schedule to show the guest. Does not reserve the dates. Maps to POST /v1/properties/{id}/quotes.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['property_id', 'check_in', 'check_out', 'adults'], 'properties': {'pets': {'type': 'integer', 'default': 0, 'minimum': 0}, 'adults': {'type': 'integer', 'minimum': 1}, 'infants': {'type': 'integer', 'default': 0, 'minimum': 0}, 'check_in': {'type': 'string', 'format': 'date'}, 'children': {'type': 'integer', 'default': 0, 'minimum': 0}, 'check_out': {'type': 'string', 'format': 'date'}, 'property_id': {'type': 'string'}}}
request_booking
Request to book
Request a stay from a quote. Set house_rules_accepted only after the guest has seen and agreed to the quote's house_rules. If the quote's payment.collected_by is "threshold", the booking starts as awaiting_payment and the response includes payment_url (and agent_payment when you can pay with a shared payment token instead): the guest must open payment_url and add a card within 60 minutes, after which the host gets the request (status pending_host_confirmation). Otherwise the request goes to the host immediately and the host arranges payment after accepting. Returns the booking and a status link to give the guest; poll get_booking for changes.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['quote_id', 'first_name', 'last_name', 'email', 'house_rules_accepted'], 'properties': {'email': {'type': 'string', 'format': 'email'}, 'phone': {'type': 'string'}, 'quote_id': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'special_requests': {'type': 'string', 'maxLength': 500}, 'house_rules_accepted': {'type': 'boolean'}}}
search_stays
Search vacation rentals
Find verified independent vacation rentals. Filters are strict: every listed amenity must be present. With dates, results include a cached availability signal and an indicative all-in total (no guest service fee). Maps to GET /v1/search.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {'pets': {'type': 'integer', 'minimum': 0}, 'limit': {'type': 'integer', 'default': 8, 'maximum': 20}, 'place': {'type': 'string', 'description': "Town and state/country, e.g. 'Asheville, NC'. Use near_lat/near_lng instead when you have coordinates."}, 'adults': {'type': 'integer', 'default': 2, 'minimum': 1}, 'infants': {'type': 'integer', 'minimum': 0}, 'check_in': {'type': 'string', 'format': 'date'}, 'children': {'type': 'integer', 'minimum': 0}, 'near_lat': {'type': 'number'}, 'near_lng': {'type': 'number'}, 'amenities': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Amenity codes, e.g. hot_tub, wifi, ev_charger, dedicated_workspace, pool, fireplace_wood.'}, 'check_out': {'type': 'string', 'format': 'date'}, 'radius_km': {'type': 'number', 'default': 25}, 'instant_only': {'type': 'boolean'}, 'min_bedrooms': {'type': 'integer'}, 'max_total_usd': {'type': 'number', 'description': 'Maximum all-in total in dollars. Requires dates.'}, 'min_wifi_mbps': {'type': 'number'}, 'step_free_entrance': {'type': 'boolean'}}}
send_message
Message the host
Send a message to the host on the guest's behalf, e.g. a question about check-in or a late arrival. Only send what the guest asked you to say. The host is emailed and replies appear in get_messages. Open from the request until two weeks after check-out.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['booking_id', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 2000}, 'booking_id': {'type': 'string'}, 'guest_email': {'type': 'string', 'format': 'email'}}}
Añadido
request_booking
4 de October de 2026 a las 02:40
Añadido
cancel_booking
4 de October de 2026 a las 02:40
Añadido
send_message
4 de October de 2026 a las 02:40
Añadido
get_messages
4 de October de 2026 a las 02:40
Añadido
ask_host
4 de October de 2026 a las 02:40
Añadido
get_booking
4 de October de 2026 a las 02:40
Añadido
get_quote
4 de October de 2026 a las 02:40
Añadido
check_availability
4 de October de 2026 a las 02:40
Añadido
get_property
4 de October de 2026 a las 02:40
Añadido
search_stays
4 de October de 2026 a las 02:40