# 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

```bash
# 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

```bash
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/`](docs/) folder:

### Essential Reading
- **[docs/architecture.md](docs/architecture.md)** - Complete architecture guide
- **[docs/quick_reference.md](docs/quick_reference.md)** - Developer quick guide
- **[docs/index.md](docs/index.md)** - Full documentation index

### Integration Guides
- **[docs/chatgpt-actions-readme.md](docs/chatgpt-actions-readme.md)** - ChatGPT setup
- **[docs/claude_desktop_setup.md](docs/claude_desktop_setup.md)** - Claude setup

### Implementation Details
- **[docs/workflow_deployment_steps.md](docs/workflow_deployment_steps.md)** - Workflows
- **[docs/redis_session_storage.md](docs/redis_session_storage.md)** - Sessions
- **[docs/login_flow_instructions.md](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

```bash
# 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](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](docs/index.md)
- [Architecture Guide](docs/architecture.md)
- [Architecture Diagrams](docs/architecture_diagram.md)
- [Reorganization Summary](docs/reorganization_summary.md)

---

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