Repository avatar
AI Tools
v1.0.0
active

vayancy-travelos

io.github.nikoskalyvas/vayancy-travelos

Mediterranean luxury villa booking rail with real-time PMS inventory & direct Stripe holds.

Documentation

๐Ÿ›๏ธ Vayancy TravelOS โ€” Model Context Protocol (MCP) Server

The Direct AI Clearing Rail for Mediterranean Luxury Villas, Boutique Hotels & Catamaran Charters

MCP Protocol Transport SSE Coverage Commission Status

Live luxury villa inventory, real-time PMS calendar sync, catamaran fleet charters, and direct-to-owner Stripe checkout โ€” directly inside your AI assistant.
Vayancy TravelOS is a hosted remote MCP server over Server-Sent Events (SSE). There is nothing to install or build locally.

Install Guide โ€ข What You Can Ask โ€ข Live Conversation Demo โ€ข Tools โ€ข Economics โ€ข Architecture


๐Ÿ’ก The Shift: From SEO to AEO (Agent Engine Optimization)

For 20 years, travel discovery was SEO: spending billions on Google Ads to fight Booking.com and Airbnb for search keywords.

Today, high-net-worth travelers don't open 40 browser tabs. They ask Claude, ChatGPT, and Gemini:

"Plan a 7-day luxury stay in Greece for 6 adults in July with an infinity pool, sea view, and a 50ft catamaran charter for 2 days under โ‚ฌ700/night."

AI assistants don't display banner ads. They check their connected MCP tools, query real-time PMS inventory, present verified direct-owner listings, and lock the dates with zero OTA middleman markups.

SEO was "rank where people search." TravelOS is "get installed where travelers ask."


โšก Server Details

  • Server URL: https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse
  • Custom Domain: https://api.vayancy.gr/mcp/hospitality/sse
  • Protocol: Model Context Protocol (MCP) over Server-Sent Events (SSE)
  • Auth: None required for public traveler queries & 15-minute holds (optional X-Tenant-Key for private agency portfolios)
  • Registry Identifier: gr.vayancy/travelos

๐Ÿ“ฆ Install

ClientHow to Install
Claude DesktopAdd vayancy to claude_desktop_config.json (1-step setup)
Claude Code/plugin marketplace add nikoskalyvas/vayancy-mcp then /plugin install vayancy@vayancy
(or claude mcp add vayancy --transport sse https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse)
CursorAdd to .cursor/mcp.json or add remote MCP server URL https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse
Gemini CLIgemini extensions install https://github.com/nikoskalyvas/vayancy-mcp
Cline & Roo CodeMCP Servers โ†’ Remote Servers โ†’ name vayancy, URL https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse
VS Code / CopilotMCP: Add Server โ†’ SSE โ†’ https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse
ChatGPTCustom GPT Action / Connector pointing to the SSE endpoint

Claude Desktop Setup

Open your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "vayancy": {
      "type": "sse",
      "url": "https://vayancy-agentic-brain-production.up.railway.app/mcp/hospitality/sse"
    }
  }
}

Restart Claude Desktop, and the hammer icon ๐Ÿ”จ will display Vayancy tools.


๐Ÿ’ฌ What You Can Ask

  • "Find me a 5-bedroom luxury villa in Lefkada for 10-11 guests with a private infinity pool and sea view for July 10-17 under โ‚ฌ700/night."
  • "Check if Villa Nidri Hills is available for August 1 to 8 for 10 guests."
  • "What are the best direct-booking luxury properties in Mykonos or Santorini for a honeymoon in September?"
  • "Find a crewed 50ft catamaran charter departing from Lefkada Marina for 8 people the second week of July."
  • "Lock Villa Nidri Hills for 15 minutes so I can book directly with the owner without Airbnb fees."

๐ŸŽฌ How Claude Fulfills a Luxury Stay

๐Ÿ‘ค Traveler:
"Find me a 5-bedroom luxury villa in Lefkada for 10 guests with a private infinity pool and sea view for July 10-17 under โ‚ฌ700/night."

๐Ÿค– Claude:
*Calling tool: search_properties(location="Lefkada", check_in="2026-07-10", check_out="2026-07-17", guests=10, max_price=700)*
*Calling tool: check_availability(unit_id="nidri-hills-villa", check_in="2026-07-10", check_out="2026-07-17", guests=10)*

"I found verified luxury villas available for your dates in Lefkada. Here is the top match:

๐Ÿ๏ธ Villa Nidri Hills (Private Infinity Pool & Panoramic Ionian Sea View)
โ€ข 5 Bedrooms ยท Sleeps up to 11 guests
โ€ข Amenities: Private infinity pool, outdoor BBQ kitchen, panoramic Skorpios/Ionian sea views, high-speed Starlink WiFi, daily housekeeping
โ€ข Direct Owner Rate: โ‚ฌ550 / night (Total: โ‚ฌ3,850 for 7 nights)
โ€ข Airbnb Comparison: โ‚ฌ4,620 (You save โ‚ฌ770 in OTA guest service fees)

Would you like me to hold this villa for 15 minutes while you finalize your flights?"

๐Ÿ‘ค Traveler:
"Yes please, lock the dates for me."

๐Ÿค– Claude:
*Calling tool: create_hold(unit_id="nidri-hills-villa", check_in="2026-07-10", check_out="2026-07-17", guests=10, guest_email="guest@luxurytravel.com")*

"Done! Villa Nidri Hills is locked on the PMS calendar for the next 15 minutes:
โ€ข Hold ID: hld_8f92a1c09e
โ€ข Expires: 15:45 UTC
โ€ข Direct Stripe Checkout: https://vayancy.gr/checkout/hld_8f92a1c09e

Click the link above to complete your booking directly with the property owner. 0% middleman fees."

๐Ÿ› ๏ธ Available MCP Tools

ToolDescription
search_propertiesSearch verified Mediterranean luxury villas, boutique hotels, and retreats. Filters by location, dates, guest count, max price, and amenities (pool,sea_view,ac,beachfront).
search_chartersSearch crewed or bareboat catamaran and yacht charters across the Greek islands (Ionian, Cyclades, Saronic).
check_availabilityVerifies real-time calendar availability directly against property management systems (PMS) before quoting.
get_rate_detailsRetrieves itemized owner rates, cleaning fees, taxes, and cancellation policies with zero OTA markup.
create_holdPlaces a 15-minute atomic reservation lock on the PMS calendar and generates a secure direct Stripe checkout link.

๐Ÿ’ฐ The Economics: Why Travelers Save 18% โ€“ 25%

FeatureLegacy OTAs (Airbnb / Booking.com)๐Ÿ›๏ธ Vayancy TravelOS (via Claude / AI)
Guest Service Fee14% โ€“ 18% markup added at checkout0% Direct Booking (Direct owner rates)
Host Commission3% โ€“ 15% deducted from payout0% Commission Rail
Average Savings$0โ‚ฌ600 โ€“ โ‚ฌ2,500+ saved per stay
Inventory HoldโŒ None (often booked while entering payment)โœ… 15-minute real-time PMS lock
Calendar SyncDelayed iCal sync (risk of double bookings)โœ… Live 2-way PMS Adapter (HostHub, WebHotelier, Avantio)
Payment RailProprietary walled-garden escrowโœ… Direct Stripe Connect direct-to-owner

๐Ÿ—๏ธ Architecture

[ Affluent Traveler ]
         โ”‚
         โ–ผ
[ Anthropic Claude / ChatGPT / Gemini / Cursor ]
         โ”‚
         โ”‚ (Model Context Protocol over SSE)
         โ–ผ
[ Vayancy TravelOS Gateway ]  โ”€โ”€>  api.vayancy.gr/mcp/hospitality/sse
         โ”‚
         โ”œโ”€โ”€ [ Real-Time PMS Sync Engine ]
         โ”‚       โ”œโ”€โ”€ HostHub / SyncBnb (Multi-channel sync)
         โ”‚       โ”œโ”€โ”€ WebHotelier (Hotels & Suites)
         โ”‚       โ””โ”€โ”€ Avantio (Luxury Villa Portfolios)
         โ”‚
         โ”œโ”€โ”€ [ Fleet Charter Sync ]
         โ”‚       โ””โ”€โ”€ NauSYS / YachtSys Real-Time Fleet Feed
         โ”‚
         โ”œโ”€โ”€ [ Inventory Lock Manager ]
         โ”‚       โ””โ”€โ”€ 15-minute atomic calendar hold
         โ”‚
         โ””โ”€โ”€ [ Direct Settlement Clearing ]
                 โ””โ”€โ”€ Direct Stripe Checkout (0% OTA markup)

๐Ÿ–๏ธ For Villa Owners & Yacht Fleet Operators

Are you a property manager, boutique hotelier, or yacht operator in Greece?

Connect your PMS or fleet calendar to Vayancy TravelOS to receive direct, commission-free reservations from travelers using AI assistants worldwide.

  • Supported PMS Adapters: HostHub (SyncBnb), WebHotelier, Avantio, Lodgify.
  • Pricing: 0% OTA commission. Direct payout to your Stripe Connect account.
  • Contact & Onboarding: Visit vayancy.gr or email admin@vayancy.gr.

๐Ÿ“„ License & Community

Distributed under the MIT License. Developed and maintained by the Vayancy team.