DragonPass MCP

DragonPass MCP Server - AI-powered interface for airport lounges, fast track, dining, eSIM and fitness services.

What is DragonPass MCP?

DragonPass MCP is a Model Context Protocol server that enables AI assistants (like Claude, Cursor, etc.) to interact with DragonPass travel services using natural language.

Example conversations:

User: "I'm flying from Hong Kong tomorrow, find me a lounge"
AI: [Uses search_lounges] Found 5 lounges at Hong Kong International Airport...

User: "Book the Plaza Premium Lounge for 2 people at 2pm"
AI: [Uses check_availability, create_lounge_booking] Booking confirmed!

Features

| Module | Services | |--------|----------| | Lounge | Search 1,500+ airport lounges, check availability, book & manage | | Fast Track | Priority security/immigration lanes at 100+ airports | | Dining | Airport restaurant coupons and set meals | | eSIM | Travel data plans for 100+ countries | | Fitness | Airport gym access and fitness classes |

Quick Start

1. Install

npm install -g dragonpass-mcp

2. Get API Credentials

Contact DragonPass to obtain:

• DRAGONPASS_CLIENT_ID
• DRAGONPASS_SECRET
• DRAGONPASS_PROGRAM_ID

3. Configure Your AI Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dragonpass": {
      "command": "npx",
      "args": ["-y", "dragonpass-mcp"],
      "env": {
        "DRAGONPASS_CLIENT_ID": "your_client_id",
        "DRAGONPASS_SECRET": "your_secret",
        "DRAGONPASS_PROGRAM_ID": "your_program_id",
        "DRAGONPASS_API_URL": "https://developer-sandbox.dragonpass.com"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dragonpass": {
      "command": "npx",
      "args": ["-y", "dragonpass-mcp"],
      "env": {
        "DRAGONPASS_CLIENT_ID": "your_client_id",
        "DRAGONPASS_SECRET": "your_secret",
        "DRAGONPASS_PROGRAM_ID": "your_program_id",
        "DRAGONPASS_API_URL": "https://developer-sandbox.dragonpass.com"
      }
    }
  }
}

4. Start Using

Restart your AI client and start chatting:

• "Find lounges at Singapore airport"
• "I need an eSIM for Japan, 7 days"
• "Book fast track at Bangkok airport for tomorrow"

Prompts (Quick Commands)

Type / in supported clients to see available quick commands:

| Command | Description | |---------|-------------| | /book-lounge | Book an airport lounge | | /find-lounge | Search for lounges | | /book-fasttrack | Book fast track service | | /get-esim | Purchase eSIM data plan | | /book-fitness | Book fitness class/day pass | | /find-dining | Find airport restaurants | | /plan-trip | Get travel recommendations | | /my-bookings | View your reservations | | /cancel-booking | Cancel a reservation | | /dragonpass-help | Learn about services |

Environment Variables

| Variable | Required | Description | Default | |----------|----------|-------------|---------| | DRAGONPASS_CLIENT_ID | Yes | API Client ID | - | | DRAGONPASS_SECRET | Yes | API Secret | - | | DRAGONPASS_PROGRAM_ID | Yes | Program ID | - | | DRAGONPASS_API_URL | No | API Base URL | https://apitest.dragonpass.com.cn | | LOG_LEVEL | No | Log level | info |

Environment URLs:

• Sandbox: https://developer-sandbox.dragonpass.com
• Production: https://developer.dragonpass.com

Available Tools (29 Total)

Lounge Module (6 Tools)

| Tool | Description | |------|-------------| | search_lounges | Search available lounges at an airport | | get_lounge_detail | Get detailed information about a specific lounge | | check_availability | Check lounge availability for a specific date and time | | create_lounge_booking | Create a new lounge booking | | get_booking_status | Check the status of an existing booking | | cancel_booking | Cancel an existing booking |

Fast Track Module (5 Tools)

| Tool | Description | |------|-------------| | search_fasttrack | Search fast track services at an airport | | get_fasttrack_detail | Get service details including pricing and requirements | | book_fasttrack | Book fast track service (requires flight number) | | get_fasttrack_booking | Check booking status | | cancel_fasttrack_booking | Cancel with refund policy |

Dining Module (5 Tools)

| Tool | Description | |------|-------------| | search_dining | Search restaurants with DragonPass offers | | get_restaurant_detail | Get restaurant details and menu | | get_available_coupons | List user's dining coupons | | redeem_coupon | Redeem coupon at restaurant | | order_set_meal | Order pre-packaged set meals |

eSIM Module (6 Tools)

| Tool | Description | |------|-------------| | list_esim_plans | Search eSIM plans by destination/region | | get_esim_plan_detail | Get full plan details | | purchase_esim | Purchase eSIM (QR sent to email) | | get_esim_status | Check usage and validity | | list_my_esims | List user's eSIMs | | topup_esim | Add data or extend validity |

Fitness Module (5 Tools)

| Tool | Description | |------|-------------| | search_fitness | Search gyms at airports/cities | | get_fitness_detail | Get venue details and class schedule | | get_fitness_pass | Get day pass for gym access | | book_fitness_class | Book yoga, HIIT, spinning classes | | cancel_fitness_booking | Cancel with refund policy |

Search Module (2 Tools)

| Tool | Description | |------|-------------| | search_airports | Search airports worldwide by location, city, or country | | search_lounges_by_location | Find lounges near your current GPS coordinates |

Natural Language Examples

Lounge Booking

User: "Find me a lounge at Hong Kong airport"
User: "What amenities does Plaza Premium Lounge have?"
User: "Is it available tomorrow at 2pm for 2 people?"
User: "Book it for me, name is John Smith, email [email protected]"

eSIM Purchase

User: "I'm traveling to Japan for a week, recommend an eSIM"
User: "How much data does the 7-day plan include?"
User: "Purchase it for me"

Fast Track

User: "Does Bangkok airport have fast track?"
User: "Book fast track for tomorrow, my flight is TG123"

Development

Local Setup

# Clone repository
git clone https://github.com/dragonpass/mcp.git
cd mcp

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Build
npm run build

# Run with MCP Inspector (for testing)
npm run inspector

Testing with MCP Inspector

npm run inspector

This opens a browser-based UI where you can:

• View all available Tools
• View all Prompts
• Test tool calls with sample data
• Debug responses

Project Structure

dragonpass-mcp/
|-- src/
|   |-- config/         # Configuration management
|   |-- prompts/        # MCP Prompts definitions
|   |-- tools/          # MCP Tool implementations
|   |   |-- lounge/     # Lounge module (6 tools)
|   |   |-- fasttrack/  # Fast Track module (5 tools)
|   |   |-- dining/     # Dining module (5 tools)
|   |   |-- esim/       # eSIM module (6 tools)
|   |   |-- fitness/    # Fitness module (5 tools)
|   |   +-- search/     # Search module (2 tools)
|   |-- clients/        # DragonPass API clients
|   |-- utils/          # Utility functions
|   +-- server.ts       # MCP Server entry point
|-- docs/               # Documentation
|-- examples/           # Client examples
+-- scripts/            # Test scripts

Scripts

npm run dev          # Development with hot reload
npm run build        # Build for production
npm run start        # Start production server
npm run inspector    # Launch MCP Inspector
npm run test         # Run tests
npm run lint         # Check code style
npm run typecheck    # TypeScript type check

Troubleshooting

Connection Failed

1. Check your API credentials are correct
2. Verify the DRAGONPASS_API_URL matches your environment (sandbox vs production)
3. Ensure your IP is whitelisted (if applicable)

Tool Not Found

1. Restart your AI client after configuration changes
2. Check the MCP server is running: npm run inspector

API Errors

Common error codes:

• 401: Invalid credentials - check CLIENT_ID and SECRET
• 403: Insufficient permissions - contact DragonPass
• 404: Resource not found - verify resourceId
• 500.xxx.xxx: See Error Code Documentation

Support

• Documentation: docs/
• API Reference: https://apifox.dragonpass.com/
• Issues: https://github.com/dragonpass/mcp/issues

License

UNLICENSED - Proprietary software. Contact DragonPass for licensing.