Marriott Hotel Booking MCP Server

v2.0 - ChatGPT Actions + Claude MCP Integration

AI-powered hotel search and booking for 8,000+ Marriott Bonvoy properties worldwide including JW Marriott, Ritz-Carlton, Westin, Sheraton, Courtyard, and more.

🚀 Quick Start

# Start the server
docker-compose up --build -d

# Run tests
npm test

# Health check
curl http://localhost:5000/health

🏗️ Architecture

This server supports three client integrations:

1. ChatGPT Actions - Atomic REST API for ChatGPT (/mcp/chatgpt/*)
2. Claude Desktop - Strict MCP protocol for Claude (/mcp/claude)
3. Custom AI Chatbots - Flexible MCP for custom bots (/mcp)

All integrations share the same core workflows and authentication.

┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│   ChatGPT   │  │   Claude    │  │   Custom    │
│   Actions   │  │  Desktop    │  │  Chatbots   │
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       │ /mcp/chatgpt/* │ /mcp/claude    │ /mcp
       │                │                │
       └────────────────┼────────────────┘
                        │
                ┌───────▼────────┐
                │  Agent Router  │
                └───────┬────────┘
                        │
        ┌───────────────┼───────────────┐
        │               │               │
   ┌────▼────┐    ┌────▼────┐    ┌────▼────┐
   │ ChatGPT │    │ Claude  │    │ Custom  │
   │  (REST) │    │  (MCP)  │    │  (MCP)  │
   └────┬────┘    └────┬────┘    └────┬────┘
        │               │               │
        └───────────────┼───────────────┘
                        │
                ┌───────▼────────┐
                │ Core Workflows │
                └────────────────┘

📁 Project Structure

uxl-mcp-c/
├── src/
│   ├── integrations/     # Platform integrations
│   │   ├── chatgpt/     # ChatGPT Actions
│   │   └── claude/      # Claude MCP
│   ├── core/            # Shared business logic
│   │   ├── auth/        # Authentication
│   │   └── workflows/   # Hotel search & booking
│   └── agent-router.js  # Main router
├── tests/               # Comprehensive test suites
│   ├── chatgpt/
│   ├── claude/
│   ├── agent-router/
│   └── integration/
├── docs/                # All documentation
└── assets/widgets/      # UI templates

🧪 Testing

npm test                        # Run all tests
npm run test:chatgpt           # ChatGPT Actions
npm run test:claude            # Claude MCP
npm run test:custom-chatbots   # Custom Chatbots
npm run test:router            # Agent Router
npm run test:integration       # End-to-end

📚 Documentation

All documentation is organized in the docs/ folder:

Essential Reading

• docs/architecture.md - Complete architecture guide
• docs/quick_reference.md - Developer quick guide
• docs/index.md - Full documentation index

Integration Guides

• docs/chatgpt-actions-readme.md - ChatGPT setup
• docs/claude_desktop_setup.md - Claude setup

Implementation Details

• docs/workflow_deployment_steps.md - Workflows
• docs/redis_session_storage.md - Sessions
• docs/login_flow_instructions.md - Authentication

🔧 Configuration

• Port 5000: Agent Router (main entry point)
• Port 5001: MCP Backend (internal)
• Port 5002: Marriott Login Gateway
• Redis: Session storage (localhost:6379)

🌟 Features

• ✅ Dual Integration: ChatGPT Actions + Claude MCP
• ✅ Hotel Search: Search 8,000+ properties
• ✅ Room Booking: Complete reservation flow
• ✅ Authentication: Marriott Bonvoy SSO
• ✅ Session Management: Redis-backed persistence
• ✅ Rich UI: Widget templates for ChatGPT
• ✅ Comprehensive Tests: 100% test coverage
• ✅ Clean Architecture: Separated concerns, easy maintenance

🛠️ Development

# Make changes to code
vim src/integrations/chatgpt/actions-router.js

# Test your changes
npm run test:chatgpt

# Rebuild and deploy
docker-compose up --build -d

See docs/quick_reference.md for detailed development guide.

📊 API Endpoints

ChatGPT Actions (REST/JSON)

• POST /mcp/chatgpt/search_hotels - Search hotels
• POST /mcp/chatgpt/book_hotel - Book hotel (consequential)

Claude Desktop (JSON-RPC 2.0)

• POST /mcp/claude - Claude Desktop MCP endpoint
  • tools/list - List available tools
  • tools/call - Execute tool

Custom AI Chatbots (JSON-RPC 2.0)

• POST /mcp - Custom chatbots MCP endpoint
  • Supports API Key, Basic Auth, or Agent ID
  • Flexible MCP implementation
  • Extended metadata in responses

Health Checks

• GET /health - Service health
• GET /ready - Readiness probe
• GET /live - Liveness probe

🤝 Contributing

1. Make changes in appropriate folders:
   • ChatGPT: src/integrations/chatgpt/
   • Claude: src/integrations/claude/
   • Shared: src/core/
2. Add tests in tests/<category>/
3. Run npm test before committing
4. Update documentation in docs/

📝 License

Marriott International, Inc. - Internal Use

🔗 Links

• Full Documentation Index
• Architecture Guide
• Architecture Diagrams
• Reorganization Summary

---

Version: 2.0
Status: ✅ Production Ready
Last Updated: May 15, 2026