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:

ChatGPT Actions - Atomic REST API for ChatGPT (/mcp/chatgpt/*)
Claude Desktop - Strict MCP protocol for Claude (/mcp/claude)
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

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

📝 License

Marriott International, Inc. - Internal Use

🔗 Links

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