Vayancy TravelOS
Server Details
Direct Mediterranean luxury villa and boutique hotel booking clearing rail with real-time PMS inventory, 15-minute hold locks, and direct Stripe checkout.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 9 tools
Each tool has a distinct resource/action role across discovery, pricing, holds, bookings, cancellation, and guest history. Descriptions explicitly include when to use and when not to use each tool, including direct contrasts between similar pairs such as check_availability vs get_rate_details and cancel_hold vs cancel_booking.
All tool names follow a predictable snake_case verb_noun pattern: search_properties, check_availability, get_rate_details, create_hold, cancel_hold, create_booking, cancel_booking, get_booking_details, get_guest_profile. There is no mixing of casing or verb conventions.
Nine tools are well scoped for a travel booking workflow, with each tool covering a necessary step: search, availability, rate quote, hold creation/release, booking creation/cancellation, booking lookup, and guest history. No tool appears redundant or padded.
The surface covers the core booking lifecycle from discovery through confirmation, cancellation, and guest history lookup. Modification of existing bookings is not a direct operation, though the descriptions document the cancel-and-rebook workaround, and payment/checkout is handled via an external Stripe URL rather than a dedicated tool.
Publisher details
- Operator
- Vayancy AI · Publisher source
- Operator website
- https://vayancy.gr/
- Vendor relationship
- Not available
- Documentation
- Not available
- Privacy policy
- Not provided
- Trust center
- Not available
- Restrictions
- Not available
Available Tools
9 toolscancel_bookingCancel Confirmed BookingADestructiveInspect
Cancel a confirmed reservation (`booking_id`) in both Vayancy and the property owner's PMS.
When to use:
- Use ONLY when a reservation has already been confirmed via `create_booking` (you have a `booking_id`) and the guest or property manager requests cancellation.
- To modify dates or switch villas on an existing confirmed booking, cancel the existing reservation with `cancel_booking` and place a new hold with `create_hold`.
When NOT to use:
- Do NOT use `cancel_booking` to release an unconfirmed 15-minute inventory hold before booking—use `cancel_hold` with `hold_id` instead.
- Do NOT use `cancel_booking` just to check whether a booking is active—use `get_booking_details` instead.
Args:
booking_id: Vayancy booking ID from create_booking
reason: Cancellation reason
guest_email: Guest email used when booking (required for public ownership verification)
Returns:
JSON object with `booking_id`, `pms_booking_id`, `success` (boolean), and updated `status` (`"cancelled"` or `"cancel_failed"`).
Inputs: booking_id (required), reason, guest_email. Returns: result
cancel_holdRelease Active Inventory HoldAInspect
Release an active, unconfirmed 15-minute inventory hold (`hold_id`) without creating a booking.
When to use:
- Use when a traveler decides not to proceed with a held villa or wants to release a `hold_id` before completing checkout or calling `create_booking`.
When NOT to use:
- Do NOT use `cancel_hold` to cancel an already confirmed reservation—use `cancel_booking` with the confirmed `booking_id` instead.
Args:
hold_id: Hold ID from create_hold
Returns:
JSON object with `success` (boolean), `hold_id`, and status `message`.
Inputs: hold_id (required). Returns: result
check_availabilityCheck Live PMS AvailabilityARead-onlyInspect
Check real-time PMS calendar availability for one specific villa or suite (`unit_id`).
Directly queries the property management system adapter (WebHotelier, Avantio, HostHub, Lodgify, Hostify)
to verify whether a known unit is open for a specific date range and guest count.
When to use:
- Use when you already have a specific `unit_id` (for example, when a traveler shifts dates or guest count on a shortlisted villa) and want a fast boolean availability check.
When NOT to use:
- Do NOT use for initial discovery across a destination or island—use `search_properties` instead.
- Do NOT use when you need itemized nightly pricing, cleaning fees, taxes, and cancellation policy—use `get_rate_details` instead.
Args:
unit_id: The unit_id from search_properties results (e.g. "n19trsyt73" or PMS unit identifier)
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
Returns:
JSON object confirming `available` (boolean), `unit_id`, `check_in`, `check_out`, `guests`, and optional `error`.
Inputs: guests (required), unit_id (required), check_in (required), check_out (required). Returns: result
create_bookingConfirm Booking via Active HoldAIdempotentInspect
Finalize and confirm a reservation in the property's PMS using an active 15-minute hold (`hold_id`).
The property owner is the merchant of record with zero OTA intermediaries.
When to use:
- Use after creating an active hold via `create_hold` to commit the reservation into the PMS (when `payment_required=False` or when authenticated with a tenant API key).
When NOT to use:
- Do NOT call `create_booking` without first locking inventory via `create_hold`.
- When `create_hold` returns `payment_required=True` on a public session, direct the guest to the `checkout_url` instead of calling `create_booking` before payment.
Args:
hold_id: Hold ID from create_hold (must be active, not expired)
guest_name: Full name of primary guest
guest_email: Guest email
guest_phone: Guest phone (international format, e.g. +306912345678)
idempotency_key: Unique key from caller — prevents double-booking on retry
notes: Optional special requests
Returns:
JSON object with `success`, `booking_id`, `pms_booking_id`, `unit_id`, `check_in`, `check_out`, `status`, and confirmation dispatch flags.
Inputs: hold_id (required), guest_name (required), guest_email (required), guest_phone (required), +2 more. Returns: result
create_holdCreate 15-Minute Inventory Hold & Stripe CheckoutAInspect
Place an exclusive 15-minute inventory hold on a villa (`unit_id`) and generate a direct Stripe Checkout URL.
Locks the property's calendar for 15 minutes so no conflicting booking can occur while the guest completes payment.
When to use:
- Use when the guest is ready to lock a specific `unit_id` and dates after reviewing `search_properties` or `get_rate_details`.
- Always call `create_hold` before calling `create_booking`.
When NOT to use:
- Do NOT use while browsing or comparing properties—use `search_properties` or `get_rate_details` instead.
- If the guest decides not to proceed after a hold is created, call `cancel_hold` (not `cancel_booking`) to release the hold.
Args:
unit_id: The unit_id returned by search_properties
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
guest_email: Primary guest email address to bind the reservation hold
Returns:
JSON object with `hold_id`, `expires_at` timestamp, `payment_required` flag, `next_step`, and direct Stripe `checkout_url`.
Inputs: guests (required), unit_id (required), check_in (required), check_out (required), +1 more. Returns: result
get_booking_detailsGet Booking DetailsARead-onlyInspect
Retrieve live reservation status, stay dates, unit details, and total amount for one specific confirmed booking (`booking_id`).
When to use:
- Use when a guest or agent has a specific `booking_id` and wants to check its confirmation status, PMS reference, dates, or total amount.
When NOT to use:
- Do NOT use `get_booking_details` to look up a guest's multi-stay booking history across a property portfolio by email alone—authenticated tenants should use `get_guest_profile` instead.
- Do NOT use before a booking is confirmed—to check pricing on an unbooked unit, use `get_rate_details`.
Args:
booking_id: Vayancy booking ID returned by create_booking
guest_email: Guest email used when booking (required for public ownership verification)
Returns:
JSON object with `booking_id`, `pms_booking_id`, `status`, `unit_id`, `unit_name`, `check_in`, `check_out`, `guests`, `guest_name`, `guest_email`, `total_amount`, and `currency`.
Inputs: booking_id (required), guest_email. Returns: result
get_guest_profileGet Guest Booking HistoryARead-onlyInspect
Retrieve a guest's multi-stay booking history (up to 10 most recent reservations) within an authenticated tenant's property portfolio.
Requires tenant authentication via the `X-Tenant-Key` header.
When to use:
- Use ONLY when an authenticated property manager or tenant agent (`X-Tenant-Key` header present) needs to list all past and upcoming stays for a returning guest by `guest_email`.
When NOT to use:
- Do NOT use `get_guest_profile` on public unauthenticated guest sessions (it will reject requests without `X-Tenant-Key`).
- Do NOT use `get_guest_profile` to look up a single reservation's live PMS details by booking ID—use `get_booking_details` with `booking_id` and `guest_email` instead.
Args:
guest_email: Guest email address
Returns:
JSON object with `guest_email`, `total_bookings` count, and `bookings` array (`booking_id`, `pms_booking_id`, `unit_id`, `check_in`, `check_out`, `guests`, `status`, `booked_at`).
Inputs: guest_email (required). Returns: result
get_rate_detailsGet Transparent Direct RatesARead-onlyInspect
Get the itemized direct-rate quote and cancellation policy for one specific villa (`unit_id`) and date range.
Fetches exact live pricing from the property owner's PMS including nightly base rate, subtotal,
cleaning fees, local tourist taxes, gross total in EUR, minimum-stay rule, and cancellation policy.
When to use:
- Use after the traveler selects a specific `unit_id` from `search_properties` to present the full itemized price quote and cancellation terms before calling `create_hold`.
When NOT to use:
- Do NOT use for broad destination search—use `search_properties` instead.
- Do NOT use just to check whether dates are open without needing price itemization—use `check_availability` instead.
Args:
unit_id: The unit_id from search_properties results
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
Returns:
JSON object with `nights`, `currency`, itemized `breakdown` (`base_rate_per_night`, `subtotal`, `cleaning_fee`, `tax`), `gross_total`, `cancellation_policy`, and `min_stay_nights`.
Inputs: guests (required), unit_id (required), check_in (required), check_out (required). Returns: result
search_propertiesSearch Luxury Villas, Hotels & Beachfront Rentals (Greece & Cyprus)ARead-onlyInspect
Search verified luxury beachfront villas, boutique hotels, and retreats across Greece and Cyprus (including Protaras, Ayia Napa, Mykonos, Santorini, Lefkada, Meganisi, Crete).
Performs a real-time two-phase search: first filters verified Mediterranean properties from the Vayancy direct catalog,
then executes live parallel PMS availability and base-rate checks directly against property management systems (WebHotelier, Avantio, HostHub, Lodgify, Hostify).
When to use:
- Use as the initial discovery step when a traveler asks for available villas or hotels in a destination/region and does not yet have a specific `unit_id`.
When NOT to use:
- Do NOT use `search_properties` to re-check availability for a single known property when the guest changes dates—use `check_availability` with that property's `unit_id` instead.
- Do NOT use `search_properties` to get an itemized quote with cleaning fees, tourist taxes, and cancellation policy—use `get_rate_details` with the chosen `unit_id` instead.
Args:
location: Island, destination, or region (e.g. "Mykonos", "Santorini", "Lefkada", "Crete", "Athens Riviera", "Paros", "Corfu", "Cyprus", "Protaras")
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
max_price: Optional maximum nightly base rate in EUR
amenities: Optional comma-separated filters: pool, sea_view, ac, bbq, beachfront, wifi, jacuzzi, gym, chef
Returns:
JSON object with `properties_found` count and `properties` list containing each available villa's `unit_id`, `name`, `location`, `base_rate` in EUR, `amenities`, `photos`, and `min_stay`.
Inputs: guests (required), check_in (required), location (required), check_out (required), +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRemote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.MIT
- AlicenseCqualityCmaintenanceCompetitor Monitor AI - MCP server providing AI-powered tools and automation by MEOK AI Labs112 npm37 PyPIMIT
- AlicenseAqualityDmaintenanceEnables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.1611 npm1MIT

industrylens-mcpofficial
AlicenseNot gradedqualityCmaintenanceBrowse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.