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 11 powerful tools for property information, rate queries, bookings, and guest services.

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

Getting Started

Connect your MCP client to this server in four simple steps:

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

Authentication is handled through API credentials. Configure your MCP client with the provided API token to access the server's tools and capabilities.

Available Tools

The server exposes 11 tools organized into four main 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

Request Tools

• createBellDeskRequest - Submit bell desk service requests
• createBillingRequest - Handle billing inquiries and requests
• createHousekeepingRequest - Submit housekeeping service requests
• createEarlyCheckInLateCheckOutRequest - Request early check-in or late check-out
• createRioRewardsRequest - Submit Rio Rewards program requests

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"
})

Submitting a Request

// Create a housekeeping request
createHousekeepingRequest({
  guestName: "John Doe",
  roomNumber: "1234",
  requestType: "Extra Towels",
  remarks: "Please deliver 4 extra towels"
})