Working Examples - Ameniti Hotel Booking MCP Server

Overview

This document provides working examples and use cases that demonstrate the core functionality of the Ameniti Hotel Booking MCP Server. These examples show how AI assistants can interact with the MCP tools to help users with hotel bookings.

⚠️ Authentication Required

All examples require OAuth 2.1 authentication. Before any MCP tool can be used:

Obtain OAuth 2.1 bearer token through proper authentication flow
Include Authorization: Bearer <token> header in all requests
Ensure token has valid permissions for the requested operations

Contact support@ameniti.ai for authentication credentials and setup guidance.

Example 1: Room Discovery and Pricing Inquiry

Scenario

A user wants to explore available rooms and get pricing for an upcoming business trip to New York City.

User Prompt

"I'm planning a business trip to New York City from December 15-18, 2025. Can you show me what room types are available at Club Quarters Grand Central and give me pricing for a Standard King room for 2 adults?"

AI Assistant Flow

Step 1: Get Available Rooms

Tool Call: get_rooms

{
  "hotelName": "Club Quarters, Grand Central"
}

Expected Response:

Room 1: Room Type: CLBQ, Description: Club Room Queen Bed, Max Occupant: 2

Room 2: Room Type: STNK, Description: Standard Room King Bed, Max Occupant: 2

Room 3: Room Type: STNQ, Description: Standard Room Queen Bed, Max Occupant: 2

Room 4: Room Type: STNTT, Description: Standard Room 2 Twin Beds, Max Occupant: 2

Room 5: Room Type: ASTNQ, Description: Standard Room Queen ADA, Max Occupant: 2

Room 6: Room Type: SUPQ, Description: Superior Room Queen Bed, Max Occupant: 2

Room 7: Room Type: SUPQKN, Description: Superior Room Queen Bed with Kitchen, Max Occupant: 2

Room 8: Room Type: STEQKT, Description: One Room Suite Queen Bed with Kitchenette, Max Occupant: 3

Room 9: Room Type: STEQKN, Description: One Room Suite Queen Bed with Kitchen, Max Occupant: 3

Step 2: Get Pricing for Standard King

Tool Call: get_price

{
  "roomTypeCode": "STNK",
  "arrivalDate": "2025-11-15",
  "departureDate": "2025-11-18",
  "adults": 2,
  "hotelName": "Club Quarters, Grand Central"
}

Expected Response:

Price: $567.00 before tax, $651.69 total after tax

AI Assistant Response

I found 9 room types available at Club Quarters Grand Central, including several options perfect for business travel:

Available Rooms:

Club Room Queen Bed (CLBQ) - 2 guests max
Standard Room King Bed (STNK) - 2 guests max ⭐ (Your requested type)
Standard Room Queen Bed (STNQ) - 2 guests max
Standard Room 2 Twin Beds (STNTT) - 2 guests max
Standard Room Queen ADA (ASTNQ) - 2 guests max
Superior Room Queen Bed (SUPQ) - 2 guests max
Superior Room Queen Bed with Kitchen (SUPQKN) - 2 guests max
One Room Suite Queen Bed with Kitchenette (STEQKT) - 3 guests max
One Room Suite Queen Bed with Kitchen (STEQKN) - 3 guests max

Pricing for Standard King Room (March 15-18, 2024):

Room rate: $567.00 (before tax)
Total cost: $651.69 (including taxes)

This is for 3 nights for 2 adults. Would you like pricing for other room types or help with booking this room?

Example 2: Complete Booking Process

Scenario

A user decides to book a room after checking availability and pricing.

User Prompt

"Perfect! I'd like to book the Standard King room at Club Quarters Grand Central for March 15-18, 2024. My details are: John Smith, email john.smith@company.com, phone +1-555-123-4567. It's for 2 guests, and I'd prefer a late checkout if possible."

AI Assistant Flow

Tool Call: setup_booking

{
  "firstName": "John",
  "lastName": "Smith",
  "email": "john.smith@company.com",
  "phoneNumber": "+1-555-123-4567",
  "checkIn": "2024-03-15",
  "checkOut": "2024-03-18",
  "guests": 2,
  "specialRequests": ["Late checkout if possible"],
  "roomType": "STNK",
  "totalPrice": 651.69,
  "hotelName": "Club Quarters, Grand Central"
}

Expected Response:

You'll receive a confirmation text to your phone number after your booking is confirmed.

Guarantee URL: https://ameniti.net/c1s423

AI Assistant Response

Excellent! I've created your booking reservation for:

Booking Details:

Guest: John Smith
Hotel: Club Quarters, Grand Central
Room: Standard King Room
Dates: March 15-18, 2024 (3 nights)
Guests: 2 adults
Special Request: Late checkout if possible
Total: $651.69

Next Steps:

Secure your reservation using this link: https://ameniti.net/c1s423
You'll receive a confirmation text at +1-555-123-4567 once reservation is secured
Your room is now held for you - payment will be processed when you check in

The guarantee link secures your booking through Stripe. No payment is charged until you arrive at the hotel.

Example 3: Booking Cancellation

Scenario

A user needs to cancel a previously made reservation due to changed travel plans.

User Prompt

"I need to cancel my reservation. My reservation ID is RES789456. Unfortunately, my business meeting was postponed and I won't be able to travel as planned."

AI Assistant Flow

Tool Call: cancel_booking

{
  "reservationId": "RES789456",
  "description": "Business meeting was postponed and travel plans changed"
}

Expected Response:

Booking cancelled successfully

AI Assistant Response

Your reservation has been successfully cancelled.

Cancellation Details:

Reservation ID: RES789456
Reason: Business meeting was postponed and travel plans changed
Status: Cancelled

Your cancellation has been processed. Since you cancelled more than 1 day before your arrival date, there are no charges. You should receive a cancellation confirmation email shortly.

If you need to rebook for different dates in the future, I'm happy to help you find new availability!

Common Usage Patterns

Pattern 1: Browse → Price → Book

Start with get_rooms to see options
Use get_price for specific room types
Complete with setup_booking

Pattern 2: Direct Booking

User knows what the room type they want
We call the get_price tool to confirm the price
Complete with setup_booking

Pattern 3: Change Management

Use cancel_booking for cancellations
Follow with new get_price and setup_booking for rebooking

Tips for AI Assistants

Best Practices

Always show pricing clearly with taxes included
Confirm guest details before booking
Explain special requests and their likelihood
Provide guarantee instructions clearly
Mention confirmation process via text message

Error Handling

Authentication failures: Guide users to contact support for OAuth credentials
Token expiration: Prompt for re-authentication when tokens expire
Gracefully handle invalid dates
Suggest alternatives for unavailable rooms
Explain cancellation policies when relevant
Provide clear next steps for guarantee issues

Authentication Error Example

Error Response:

HTTP 401 Unauthorized
"error": "Authentication required. Please provide valid OAuth bearer token."

AI Assistant Response:

"I need to authenticate with the booking system first. Please contact support@ameniti.ai to obtain the necessary OAuth credentials for hotel booking access."

User Experience

Use clear, conversational language
Summarize booking details before final confirmation
Offer helpful suggestions (room upgrades, amenities)
Be proactive about special needs (accessibility, business features)

These examples demonstrate the MCP server's capability to handle diverse booking scenarios efficiently and provide excellent user experiences through AI assistant interactions.