Servidor MCP

mcp

com.stayportland/mcp
Viajes y hospitalidad Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches Portland rental properties, compares listings, saves shortlists, provides live quotes, and prepares or completes guest-approved hosted checkouts without directly handling payment details.

compare_properties
Compare selected Portland rentals
Render a visual, source-grounded comparison for two to five listing ids or slugs selected from search_properties. Preserves the requested order and returns public listing profiles.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 5, 'minItems': 2}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['properties', 'compared', 'guidance'], 'properties': {'compared': {'type': 'number'}, 'guidance': {'type': 'string'}, 'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'description', 'sleeps', 'bedrooms', 'bathrooms', 'beds', 'squareFeet', 'propertyType', 'roomType', 'neighborhood', 'petsAllowed', 'parking', 'minNights', 'houseRules', 'amenities', 'fromNightly', 'cleaningFee', 'checkinTime', 'checkoutTime', 'rating', 'reviewCount', 'reviewSummary', 'image', 'photos', 'bookUrl', 'markdownUrl'], 'properties': {'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'slug': {'type': 'string'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 12}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sleeps': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'bookUrl': {'type': 'string'}, 'parking': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'bedrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'roomType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'amenities': {'type': 'array', 'items': {'type': 'string'}}, 'bathrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'minNights': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'houseRules': {'type': 'array', 'items': {'type': 'string'}}, 'squareFeet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'checkinTime': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'cleaningFee': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'fromNightly': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'markdownUrl': {'type': 'string'}, 'petsAllowed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'reviewCount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'checkoutTime': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'neighborhood': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'propertyType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviewSummary': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 5}}, 'additionalProperties': False}
complete_booking
Complete an already approved booking
Resume the site's existing reservation finalizer only after the guest approved and authorized payment in hosted checkout. This cannot create or authorize a payment. Completion is controlled by a server flag; check status to follow an in-progress checkout.
Destructivo Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bookingCapability'], 'properties': {'bookingCapability': {'type': 'string', 'maxLength': 900, 'minLength': 100}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['state', 'nextAction', 'quoteId', 'checkoutUrl', 'note'], 'properties': {'note': {'type': 'string'}, 'state': {'enum': ['awaiting_guest', 'awaiting_payment', 'needs_guest_action', 'payment_processing', 'finalizing', 'confirmed', 'assistance_required'], 'type': 'string'}, 'quoteId': {'type': 'string'}, 'nextAction': {'enum': ['open_checkout', 'finish_guest_verification', 'wait', 'complete_booking', 'contact_support', 'done'], 'type': 'string'}, 'checkoutUrl': {'type': 'string'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}
get_booking_status
Check a prepared booking
Read the coarse status of the exact checkout prepared by this agent. Requires its private booking capability. Returns no guest, card, PaymentIntent, or reservation identifiers.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bookingCapability'], 'properties': {'bookingCapability': {'type': 'string', 'maxLength': 900, 'minLength': 100}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['state', 'nextAction', 'quoteId', 'checkoutUrl', 'note'], 'properties': {'note': {'type': 'string'}, 'state': {'enum': ['awaiting_guest', 'awaiting_payment', 'needs_guest_action', 'payment_processing', 'finalizing', 'confirmed', 'assistance_required'], 'type': 'string'}, 'quoteId': {'type': 'string'}, 'nextAction': {'enum': ['open_checkout', 'finish_guest_verification', 'wait', 'complete_booking', 'contact_support', 'done'], 'type': 'string'}, 'checkoutUrl': {'type': 'string'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}
get_collection_overview
Discover Stay Portland
Public portfolio overview: live home count, Portland neighborhoods, direct-booking advantages, policies, and the no-payment tool boundary.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name', 'city', 'listingCount', 'neighborhoods', 'advantages', 'bookingBoundary', 'browseUrl', 'policiesUrl'], 'properties': {'city': {'type': 'string', 'const': 'Portland, Oregon'}, 'name': {'type': 'string', 'const': 'Stay Portland'}, 'browseUrl': {'type': 'string'}, 'advantages': {'type': 'array', 'items': {'type': 'string'}}, 'policiesUrl': {'type': 'string'}, 'listingCount': {'type': 'number'}, 'neighborhoods': {'type': 'array', 'items': {'type': 'string'}}, 'bookingBoundary': {'type': 'string'}}, 'additionalProperties': False}
get_listing
View a property profile
Full profile for one listing by Guesty id or slug: specs, amenities, rules, prices.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listing'], 'properties': {'listing': {'type': 'string', 'maxLength': 200, 'description': '24-hex Guesty id or property slug'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug', 'title', 'description', 'sleeps', 'bedrooms', 'bathrooms', 'beds', 'squareFeet', 'propertyType', 'roomType', 'neighborhood', 'petsAllowed', 'parking', 'minNights', 'houseRules', 'amenities', 'fromNightly', 'cleaningFee', 'checkinTime', 'checkoutTime', 'rating', 'reviewCount', 'reviewSummary', 'image', 'photos', 'bookUrl', 'markdownUrl'], 'properties': {'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'slug': {'type': 'string'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 12}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sleeps': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'bookUrl': {'type': 'string'}, 'parking': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'bedrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'roomType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'amenities': {'type': 'array', 'items': {'type': 'string'}}, 'bathrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'minNights': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'houseRules': {'type': 'array', 'items': {'type': 'string'}}, 'squareFeet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'checkinTime': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'cleaningFee': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'fromNightly': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'markdownUrl': {'type': 'string'}, 'petsAllowed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'reviewCount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'checkoutTime': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'neighborhood': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'propertyType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviewSummary': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
get_policies
Read booking policies
Canonical Stay Portland policies: fees, cancellation, pets, check-in, taxes, parking, house rules.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['markdown'], 'properties': {'markdown': {'type': 'string'}}, 'additionalProperties': False}
get_quote
Get an all-in quote
Live all-in quote (nights + cleaning + taxes) and a checkout URL. Hand the guest the URL; never collect card details.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listing', 'checkin', 'checkout'], 'properties': {'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'listing': {'type': 'string', 'maxLength': 200}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0, 'description': 'Pets attending; their checkout fees and applicable taxes are excluded from this base quote and must be approved in hosted checkout.'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quoteId', 'listingTitle', 'checkin', 'checkout', 'guests', 'nights', 'accommodation', 'cleaning', 'taxes', 'total', 'totalCents', 'currency', 'checkoutUrl', 'expiresNote', 'note'], 'properties': {'note': {'type': 'string'}, 'taxes': {'type': 'number'}, 'total': {'type': 'number'}, 'guests': {'type': 'number'}, 'nights': {'type': 'number'}, 'checkin': {'type': 'string'}, 'quoteId': {'type': 'string'}, 'checkout': {'type': 'string'}, 'cleaning': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'USD'}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'expiresAt': {'type': 'string'}, 'totalCents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'checkoutUrl': {'type': 'string'}, 'expiresNote': {'type': 'string'}, 'listingTitle': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'accommodation': {'type': 'number'}, 'inventoryHeld': {'type': 'boolean', 'const': False}, 'priceExcludes': {'type': 'array', 'items': {'type': 'string'}}, 'priceIncludes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_reviews
Read guest reviews
Recent guest reviews — for one listing (by Guesty id or slug) or across the whole collection. Text, rating, and month+year only.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sort': {'enum': ['recent', 'rating_high'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'offset': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'listing': {'type': 'string', 'maxLength': 200, 'description': '24-hex Guesty id or property slug; omit for all homes'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scope', 'count', 'averageRating', 'nextOffset', 'reviews'], 'properties': {'count': {'type': 'number'}, 'scope': {'enum': ['property', 'collection'], 'type': 'string'}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['rating', 'date', 'text'], 'properties': {'date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'YYYY-MM'}, 'text': {'type': 'string', 'maxLength': 2000}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'nextOffset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'averageRating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}
get_shortlist
Read the guest's saved list
List every property saved in this conversation. Pass the sessionToken returned by shortlist_property; refer to it with the guest only as "your saved list".
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['session_token'], 'properties': {'session_token': {'type': 'string', 'maxLength': 200, 'description': 'the sessionToken returned by shortlist_property'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sessionToken', 'items', 'note'], 'properties': {'note': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['listingId', 'title', 'markdownUrl'], 'properties': {'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'listingId': {'type': 'string'}, 'markdownUrl': {'type': 'string'}}, 'additionalProperties': False}}, 'sessionToken': {'type': 'string'}}, 'additionalProperties': False}
prepare_booking
Prepare a guest-approved booking
Create a fresh exact-date quote and secure hosted checkout link. Share the link with the guest for price review, details and payment approval. This tool never books, charges, or accepts card details. Its capability lets this agent check only this quote's booking status.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listing', 'checkin', 'checkout'], 'properties': {'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'listing': {'type': 'string', 'maxLength': 200}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0, 'description': 'Pets attending; their checkout fees and applicable taxes are excluded from this base quote and must be approved in hosted checkout.'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quoteId', 'listingTitle', 'checkin', 'checkout', 'guests', 'nights', 'accommodation', 'cleaning', 'taxes', 'total', 'totalCents', 'currency', 'checkoutUrl', 'expiresNote', 'note', 'bookingCapability', 'capabilityExpiresAt', 'guestApprovalRequired'], 'properties': {'note': {'type': 'string'}, 'taxes': {'type': 'number'}, 'total': {'type': 'number'}, 'guests': {'type': 'number'}, 'nights': {'type': 'number'}, 'checkin': {'type': 'string'}, 'quoteId': {'type': 'string'}, 'checkout': {'type': 'string'}, 'cleaning': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'USD'}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'expiresAt': {'type': 'string'}, 'totalCents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'checkoutUrl': {'type': 'string'}, 'expiresNote': {'type': 'string'}, 'listingTitle': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'accommodation': {'type': 'number'}, 'inventoryHeld': {'type': 'boolean', 'const': False}, 'priceExcludes': {'type': 'array', 'items': {'type': 'string'}}, 'priceIncludes': {'type': 'array', 'items': {'type': 'string'}}, 'bookingCapability': {'type': 'string'}, 'capabilityExpiresAt': {'type': 'string'}, 'guestApprovalRequired': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}
search_priced_availability
Search rentals with confirmed prices
Search Stay Portland's live availability for one required date range and return up to six exact base quotes per page. Use this first when a traveler provides dates and asks for options, full prices, fees, taxes, a budget comparison, or checkout links. Each result includes the home, accommodation, cleaning, taxes, USD base total, excluded pet fees and extras, and temporary checkout URL. Price sorting applies within the returned page. Use nextOffset to continue through matching inventory; retry unpricedProperties individually with get_quote. Quote creation never reserves, books, charges, or collects payment details.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['checkin', 'checkout'], 'properties': {'q': {'type': 'string', 'maxLength': 200, 'description': 'public feature, neighborhood, or listing-copy criteria'}, 'beds': {'type': 'integer', 'maximum': 24, 'minimum': 0}, 'pets': {'type': 'boolean'}, 'sort': {'enum': ['recommended', 'price_low', 'price_high', 'rating', 'capacity_fit'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 6, 'minimum': 1}, 'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'offset': {'type': 'integer', 'maximum': 300, 'minimum': 0}, 'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'bedrooms': {'type': 'integer', 'maximum': 8, 'minimum': 0}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'personas': {'type': 'array', 'items': {'enum': ['family', 'groups', 'luxury', 'budget', 'extended_stay', 'remote_work', 'romantic'], 'type': 'string'}, 'maxItems': 5}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0, 'description': 'Pets attending; their checkout fees and applicable taxes are excluded from this base quote and must be approved in hosted checkout.'}, 'amenities': {'type': 'array', 'items': {'enum': ['hot_tub', 'fireplace', 'backyard', 'workspace', 'wifi', 'air_conditioning', 'washer', 'dryer', 'kitchen', 'crib', 'high_chair', 'elevator', 'parking'], 'type': 'string'}, 'maxItems': 12}, 'bathrooms': {'type': 'integer', 'maximum': 12, 'minimum': 0}, 'maxNightly': {'type': 'number', 'maximum': 10000, 'exclusiveMinimum': 0}, 'neighborhood': {'type': 'string', 'maxLength': 200}, 'propertyTypes': {'type': 'array', 'items': {'enum': ['apartment', 'house', 'condominium', 'townhouse', 'loft', 'bungalow', 'cabin'], 'type': 'string'}, 'maxItems': 7}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['properties', 'count', 'availableCount', 'unpricedCount', 'hasMore', 'nextOffset', 'checkin', 'checkout', 'guests', 'pagePriceRange', 'note'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'guests': {'type': 'number'}, 'checkin': {'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'checkout': {'type': 'string'}, 'incomplete': {'type': 'boolean'}, 'nextOffset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['property', 'quote'], 'properties': {'quote': {'type': 'object', 'required': ['quoteId', 'listingTitle', 'checkin', 'checkout', 'guests', 'nights', 'accommodation', 'cleaning', 'taxes', 'total', 'totalCents', 'currency', 'checkoutUrl', 'expiresNote', 'note'], 'properties': {'note': {'type': 'string'}, 'taxes': {'type': 'number'}, 'total': {'type': 'number'}, 'guests': {'type': 'number'}, 'nights': {'type': 'number'}, 'checkin': {'type': 'string'}, 'quoteId': {'type': 'string'}, 'checkout': {'type': 'string'}, 'cleaning': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'USD'}, 'petCount': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'expiresAt': {'type': 'string'}, 'totalCents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'checkoutUrl': {'type': 'string'}, 'expiresNote': {'type': 'string'}, 'listingTitle': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'accommodation': {'type': 'number'}, 'inventoryHeld': {'type': 'boolean', 'const': False}, 'priceExcludes': {'type': 'array', 'items': {'type': 'string'}}, 'priceIncludes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'property': {'type': 'object', 'required': ['slug', 'title', 'sleeps', 'bedrooms', 'bathrooms', 'neighborhood', 'petsAllowed', 'fromNightly', 'stayTotal', 'currency', 'image', 'bookUrl', 'markdownUrl'], 'properties': {'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'slug': {'type': 'string'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sleeps': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'bookUrl': {'type': 'string'}, 'bedrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'currency': {'type': 'string', 'const': 'USD'}, 'bathrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'stayTotal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchScore': {'type': 'number'}, 'priceBasis': {'enum': ['from-nightly-accommodation', 'dated-stay-accommodation-pre-tax'], 'type': 'string'}, 'fromNightly': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'markdownUrl': {'type': 'string'}, 'petsAllowed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'reviewCount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchReasons': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'label', 'evidence'], 'properties': {'kind': {'enum': ['amenity', 'persona', 'query'], 'type': 'string'}, 'label': {'type': 'string'}, 'evidence': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 6}, 'neighborhood': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'propertyType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'availableCheckin': {'type': 'string'}, 'availableCheckout': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 6}, 'unpricedCount': {'type': 'number'}, 'availableCount': {'type': 'number'}, 'pagePriceRange': {'anyOf': [{'type': 'object', 'required': ['minTotal', 'maxTotal', 'currency'], 'properties': {'currency': {'type': 'string', 'const': 'USD'}, 'maxTotal': {'type': 'number'}, 'minTotal': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'unpricedProperties': {'type': 'array', 'items': {'type': 'object', 'required': ['listing', 'reason'], 'properties': {'reason': {'enum': ['unavailable', 'provider_error', 'deadline'], 'type': 'string'}, 'listing': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_properties
Search Stay Portland rentals
Search Portland rentals across up to five date windows with verified layout, amenity, traveler-fit, accommodation-only price, rating, and neighborhood evidence. Dated results are live-bookable only. Use search_priced_availability when a traveler provides one date range and needs confirmed base prices including cleaning and stay taxes. After choosing candidates, call compare_properties for the visual explorer. Stay Portland charges no platform or booking fees when you book direct, and every direct booking comes with our guaranteed lowest price.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'description': 'public feature, neighborhood, or listing-copy criteria'}, 'beds': {'type': 'integer', 'maximum': 24, 'minimum': 0}, 'pets': {'type': 'boolean'}, 'sort': {'enum': ['recommended', 'price_low', 'price_high', 'rating', 'capacity_fit'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'offset': {'type': 'integer', 'maximum': 300, 'minimum': 0}, 'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'bedrooms': {'type': 'integer', 'maximum': 8, 'minimum': 0}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'personas': {'type': 'array', 'items': {'enum': ['family', 'groups', 'luxury', 'budget', 'extended_stay', 'remote_work', 'romantic'], 'type': 'string'}, 'maxItems': 5}, 'amenities': {'type': 'array', 'items': {'enum': ['hot_tub', 'fireplace', 'backyard', 'workspace', 'wifi', 'air_conditioning', 'washer', 'dryer', 'kitchen', 'crib', 'high_chair', 'elevator', 'parking'], 'type': 'string'}, 'maxItems': 12}, 'bathrooms': {'type': 'integer', 'maximum': 12, 'minimum': 0}, 'maxNightly': {'type': 'number', 'maximum': 10000, 'exclusiveMinimum': 0}, 'dateWindows': {'type': 'array', 'items': {'type': 'object', 'required': ['checkin', 'checkout'], 'properties': {'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}}}, 'maxItems': 5, 'minItems': 1}, 'neighborhood': {'type': 'string', 'maxLength': 200}, 'propertyTypes': {'type': 'array', 'items': {'enum': ['apartment', 'house', 'condominium', 'townhouse', 'loft', 'bungalow', 'cabin'], 'type': 'string'}, 'maxItems': 7}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['properties', 'count', 'hasMore', 'nextOffset', 'dated', 'note'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'dated': {'type': 'boolean'}, 'guests': {'type': 'number'}, 'checkin': {'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'checkout': {'type': 'string'}, 'nextOffset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'priceBasis': {'enum': ['from-nightly-accommodation', 'dated-stay-accommodation-pre-tax'], 'type': 'string'}, 'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'sleeps', 'bedrooms', 'bathrooms', 'neighborhood', 'petsAllowed', 'fromNightly', 'stayTotal', 'currency', 'image', 'bookUrl', 'markdownUrl'], 'properties': {'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'slug': {'type': 'string'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sleeps': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'bookUrl': {'type': 'string'}, 'bedrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'currency': {'type': 'string', 'const': 'USD'}, 'bathrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'stayTotal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchScore': {'type': 'number'}, 'priceBasis': {'enum': ['from-nightly-accommodation', 'dated-stay-accommodation-pre-tax'], 'type': 'string'}, 'fromNightly': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'markdownUrl': {'type': 'string'}, 'petsAllowed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'reviewCount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchReasons': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'label', 'evidence'], 'properties': {'kind': {'enum': ['amenity', 'persona', 'query'], 'type': 'string'}, 'label': {'type': 'string'}, 'evidence': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 6}, 'neighborhood': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'propertyType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'availableCheckin': {'type': 'string'}, 'availableCheckout': {'type': 'string'}}, 'additionalProperties': False}}, 'dateOptions': {'type': 'array', 'items': {'type': 'object', 'required': ['checkin', 'checkout', 'count', 'hasMore', 'nextOffset', 'properties'], 'properties': {'count': {'type': 'number'}, 'checkin': {'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'checkout': {'type': 'string'}, 'nextOffset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'sleeps', 'bedrooms', 'bathrooms', 'neighborhood', 'petsAllowed', 'fromNightly', 'stayTotal', 'currency', 'image', 'bookUrl', 'markdownUrl'], 'properties': {'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'slug': {'type': 'string'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sleeps': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'bookUrl': {'type': 'string'}, 'bedrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'currency': {'type': 'string', 'const': 'USD'}, 'bathrooms': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'stayTotal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchScore': {'type': 'number'}, 'priceBasis': {'enum': ['from-nightly-accommodation', 'dated-stay-accommodation-pre-tax'], 'type': 'string'}, 'fromNightly': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'markdownUrl': {'type': 'string'}, 'petsAllowed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'reviewCount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'matchReasons': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'label', 'evidence'], 'properties': {'kind': {'enum': ['amenity', 'persona', 'query'], 'type': 'string'}, 'label': {'type': 'string'}, 'evidence': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 6}, 'neighborhood': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'propertyType': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'availableCheckin': {'type': 'string'}, 'availableCheckout': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 4}, 'availableCount': {'type': 'number'}}, 'additionalProperties': False}, 'maxItems': 5}, 'availableCount': {'type': 'number'}}, 'additionalProperties': False}
shortlist_property
Save a property to the guest's list
Save one property to the guest's list for this conversation, or drop it with remove: true. The result carries a sessionToken — reuse that exact token on every later shortlist_property and get_shortlist call in this conversation. Never read the token out to the guest; refer to it only as "your saved list". Saving creates no account and never collects card details.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listing'], 'properties': {'remove': {'type': 'boolean', 'description': 'true to remove the property from the list'}, 'listing': {'type': 'string', 'maxLength': 200, 'description': '24-hex Guesty id or property slug'}, 'session_token': {'type': 'string', 'maxLength': 200, 'description': 'the sessionToken from an earlier shortlist call; omit only for the first save in a conversation'}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sessionToken', 'items', 'note'], 'properties': {'note': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['listingId', 'title', 'markdownUrl'], 'properties': {'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'listingId': {'type': 'string'}, 'markdownUrl': {'type': 'string'}}, 'additionalProperties': False}}, 'sessionToken': {'type': 'string'}}, 'additionalProperties': False}
suggest_alternate_dates
Find nearby available dates
For one live listing, find the closest calendar-confirmed stays with the same length when preferred dates do not work. Results are not priced; call get_quote for the final total.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listing', 'checkin', 'checkout'], 'properties': {'limit': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'checkin': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'listing': {'type': 'string', 'maxLength': 200}, 'checkout': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10, 'description': 'YYYY-MM-DD'}, 'flexDays': {'type': 'integer', 'maximum': 14, 'minimum': 1}}}
Esquema de salida
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listingId', 'listingTitle', 'requestedCheckin', 'requestedCheckout', 'alternatives', 'note'], 'properties': {'note': {'type': 'string'}, 'listingId': {'type': 'string'}, 'alternatives': {'type': 'array', 'items': {'type': 'object', 'required': ['checkin', 'checkout', 'nights', 'shiftDays'], 'properties': {'nights': {'type': 'number'}, 'checkin': {'type': 'string'}, 'checkout': {'type': 'string'}, 'shiftDays': {'type': 'number'}}, 'additionalProperties': False}}, 'listingTitle': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'requestedCheckin': {'type': 'string'}, 'requestedCheckout': {'type': 'string'}}, 'additionalProperties': False}
Modificado
get_policies
23 de September de 2026 a las 02:54
Modificado
get_shortlist
23 de September de 2026 a las 02:54
Modificado
get_reviews
23 de September de 2026 a las 02:54
Modificado
get_quote
23 de September de 2026 a las 02:54
Modificado
get_listing
23 de September de 2026 a las 02:54
Modificado
get_collection_overview
23 de September de 2026 a las 02:54
Modificado
suggest_alternate_dates
23 de September de 2026 a las 02:54
Modificado
compare_properties
23 de September de 2026 a las 02:54
Modificado
search_priced_availability
23 de September de 2026 a las 02:54
Modificado
search_properties
23 de September de 2026 a las 02:54
Añadido
complete_booking
23 de September de 2026 a las 02:54
Añadido
get_booking_status
23 de September de 2026 a las 02:54
Añadido
prepare_booking
23 de September de 2026 a las 02:54
Añadido
get_policies
17 de September de 2026 a las 12:37
Añadido
get_shortlist
17 de September de 2026 a las 12:37
Añadido
shortlist_property
17 de September de 2026 a las 12:37
Añadido
get_reviews
17 de September de 2026 a las 12:37
Añadido
get_quote
17 de September de 2026 a las 12:37
Añadido
get_listing
17 de September de 2026 a las 12:37
Añadido
get_collection_overview
17 de September de 2026 a las 12:37
Añadido
suggest_alternate_dates
17 de September de 2026 a las 12:37
Añadido
compare_properties
17 de September de 2026 a las 12:37
Añadido
search_priced_availability
17 de September de 2026 a las 12:37
Añadido
search_properties
17 de September de 2026 a las 12:37