MCP Server Documentation

Overview

The Model Context Protocol (MCP) server provides a standardized interface for AI assistants to interact with hotel booking operations. This server exposes 6 tools for property information, rate queries, and bookings.

Built for Traversing.ai, this server enables seamless integration between AI agents and hotel systems.

Getting Started

Connect an AI Assistant

Add this server to any AI assistant that supports remote MCP servers using this URL:

https://mcp.baymahni.com/mcp

Claude: open Customize > Connectors, add a custom connector, and paste the URL. No sign-in is needed. Then turn the connector on from + > Connectors in a chat and ask about Baymahni.

Connection Endpoints

The server provides two primary endpoints:

• MCP Protocol: /mcp - Main endpoint for tool access and operations
• Server-Sent Events: /sse - Real-time event streaming for live updates

Authentication

The MCP endpoints do not require end-user authentication. Guests complete and manage reservations in the booking engine.

Available Tools

The server exposes 6 tools organized into 3 categories:

Property Tools

• getProperty - Retrieve detailed property information including images, amenities, and bookable units
• listBookableUnits - List all available bookable units across properties
• showImages - Display property or room images

Rate Tools

• getRates - Query rates and availability for specific dates and room types

Booking Tools

• createBooking - Generate a booking link for guests to complete their reservation
• cancelBooking - Provide a cancellation link for existing reservations

Usage Examples

Here are some common workflows using the MCP server:

Checking Availability

// Query rates for a specific room and dates
getRates({
  bookableUnitSlug: "deluxe-king",
  checkIn: "2025-12-01",
  checkOut: "2025-12-05",
  adultGuests: 2,
  kidGuests: 0
})

Creating a Booking

// Generate a booking link for the guest
createBooking({
  bookableUnitSlug: "deluxe-king",
  checkIn: "2025-12-01",
  checkOut: "2025-12-05",
  adults: 2,
  kids: 0,
  ratePlanCode: "BAR"
})