CVamsi27/travel-mcp-server

Travel MCP Server (Amadeus API)

An MCP (Model Context Protocol) server for Amadeus travel APIs, providing flight, hotel, airport, and tourism data directly to Claude Desktop or any MCP-compatible client.

Features

• Flight Services: Search flights, get cheapest dates, flight inspiration, pricing, availability, analytics (18 tools)
• Hotel Services: Search hotels, get details, ratings, booking, autocomplete (7 tools)
• Airport & Airline Data: Airport search, airline lookup, routes, on-time performance (7 tools)
• Travel Services: Transfers, tours & activities, points of interest, travel recommendations (11 tools)
• Advanced Analytics: Flight delay prediction, price analysis, trip purpose prediction
• Real-time Data: Flight status, seat maps, travel restrictions
• 43 total tools with comprehensive caching and rate limiting

Quick Start

Prerequisites

• Node.js 18+ or higher
• pnpm (recommended) or npm
• Amadeus API credentials (free at developers.amadeus.com)

Installation

git clone https://github.com/CVamsi27/travel-mcp-server
cd travel-mcp-server
pnpm install

Configuration

1. Get Amadeus API credentials (free test environment):

   • Sign up at Amadeus for Developers
   • Create a new app → Choose "Test Environment"
   • Copy your API Key and Secret

2. Create environment file:

# .env file
AMADEUS_CLIENT_ID=your_test_api_key_here
AMADEUS_CLIENT_SECRET=your_test_api_secret_here
AMADEUS_HOSTNAME=test
CACHE_TTL_MINUTES=5
RATE_LIMIT_REQUESTS=5
MAX_RETRIES=3

3. Test your setup:

pnpm test
# Should show: ✓ Connection successful!

Claude Desktop Integration

Setup Claude Desktop Config

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "travel-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/travel-mcp-server/index.js"],
      "env": {
        "AMADEUS_CLIENT_ID": "your_test_api_key_here",
        "AMADEUS_CLIENT_SECRET": "your_test_api_secret_here",
        "AMADEUS_HOSTNAME": "test"
      }
    }
  }
}

Replace /absolute/path/to/travel-mcp-server/ with your actual installation path.

Restart Claude Desktop

After updating the config, restart Claude Desktop completely for changes to take effect.

Example Usage with Claude

Once configured, you can use natural language to search flights and hotels:

Flight Search Examples

Basic flight search:

Find flights from New York to Los Angeles on September 15th, 2025

Round trip with multiple passengers:

Search for round-trip flights from London to Paris, departing September 20th and returning September 27th for 2 adults

Find cheapest dates:

What are the cheapest dates to fly from JFK to LAX?

Flight inspiration:

Show me destination inspiration from New York (JFK)

Flight analytics:

Get flight price analysis for JFK to LAX on September 15th, 2025

Hotel Search Examples

City hotel search:

Find hotels in Paris for check-in September 15th and check-out September 18th for 2 adults

Location-based search:

Search for hotels near Times Square (latitude 40.7589, longitude -73.9851)

Hotel details:

Get details for hotel HLPAR123 for September 15-18, 2025

Airport & Airline Examples

Airport search:

Find airports near London

Nearest airports:

What are the nearest airports to coordinates 51.4700, -0.4543?

Airline information:

Look up information for airline codes AA, UA, and BA

Airport performance:

Get on-time performance data for LHR airport

Travel Services Examples

Ground transfers:

Find private transfers from CDG airport to Paris on September 15th at 10:00 AM

Tours and activities:

Search for tours and activities near the Eiffel Tower (48.8566, 2.3522)

Points of interest:

Find restaurants and sights near Times Square within 2km

Travel restrictions:

What are the travel restrictions from US to France?

Available Tools (43 Total)

Flight Tools (18)

• searchFlights - Search flight offers between locations
• getCheapestFlightDate - Find cheapest travel dates
• getFlightInspiration - Get destination inspiration
• getFlightOffersPrice - Price specific flight offers
• searchFlightAvailabilities - Check flight availability
• getFlightBusiestPeriod - Airport traffic analytics
• getFlightMostBookedDestinations - Popular destinations
• getFlightMostTraveledDestinations - Travel pattern analysis
• getFlightPriceAnalysis - Price trend analysis
• getFlightChoicePrediction - ML-powered choice prediction
• getFlightDelayPrediction - Delay probability analysis
• getFlightStatus - Real-time flight status
• getFlightCheckinLinks - Airline check-in URLs
• getSeatMap - Aircraft seat maps
• createFlightOrder - Book flights (production)
• getFlightOrder - Retrieve bookings
• deleteFlightOrder - Cancel bookings
• getBrandedFares - Premium fare options

Hotel Tools (7)

• searchHotelsByCity - Search hotels by city code
• getHotelDetails - Detailed hotel information and offers
• searchHotelsByLocation - Location-based hotel search
• searchHotels - General hotel search with filters
• getHotelList - Hotel listings with chain/amenity filters
• getHotelNameAutocomplete - Hotel name suggestions
• getHotelRatings - Hotel sentiment analysis and ratings

Airport & Airline Tools (7)

• searchAirportsAndCities - Airport and city search
• getNearestRelevantAirports - Find nearby airports
• getAirportOnTimePerformance - Airport performance metrics
• getAirportRoutes - Destinations served by airport
• lookupAirlineCode - Airline information lookup
• getAirlineRoutes - Airline route network
• searchCities - City search with country filters

Travel Services Tools (11)

• searchTransfers - Ground transfer search (taxi, private, etc.)
• searchToursAndActivities - Local activities and tours
• getActivityDetails - Detailed activity information
• getPointsOfInterest - POI discovery (restaurants, sights, etc.)
• getPointOfInterestDetails - Detailed POI information
• getLocationScore - Location quality scoring
• getTravelRecommendations - AI-powered destination suggestions
• getTravelRestrictions - Current travel requirements
• parseTripData - Parse travel documents
• predictTripPurpose - Trip purpose analysis (business/leisure)

Advanced Features

Flight Analytics & Predictions

Predict delays for flight AA100 from JFK to LAX on September 15th

Hotel Sentiment Analysis

Get ratings and reviews sentiment for hotels HLPAR123,HLPAR456

Location Intelligence

Get location score for coordinates 48.8566, 2.3522 (Eiffel Tower area)

Trip Purpose Prediction

Predict if a NYC to LAX trip departing December 15th returning December 18th is business or leisure

Error Handling & Rate Limits

The server includes comprehensive error handling:

• Automatic retries with exponential backoff
• Rate limiting with configurable limits
• Response caching to reduce API calls
• Input validation for all parameters
• Detailed error messages for debugging

Test Environment Limits

• Limited API calls per month
• Some endpoints may be restricted
• Rate limits apply per endpoint

Production Environment

• Higher limits available
• Full API access
• Pay-per-use pricing

Troubleshooting

Common Issues

1. "Tool not found" errors

   • Restart Claude Desktop after config changes
   • Verify the absolute path in claude_desktop_config.json

2. "Missing API credentials"

   • Check your .env file or environment variables
   • Verify credentials at Amadeus developer dashboard

3. "Date/Time is in the past"

   • Always use future dates (tomorrow or later)
   • Format: YYYY-MM-DD

4. "Invalid IATA codes"

   • Use 3-letter airport codes (JFK, LAX, LHR)
   • Use city codes (NYC, LON, PAR) for city-based searches

5. API Rate Limits

   • Test environment has limited calls
   • Check your Amadeus dashboard for usage
   • Wait between requests or upgrade to production

Enable Debug Logging

AMADEUS_LOG_LEVEL=debug

Test Connection

node diagnostic.js

Production Deployment

When ready for production:

1. Upgrade to production API:

   AMADEUS_HOSTNAME=production
   AMADEUS_CLIENT_ID=your_production_key
   AMADEUS_CLIENT_SECRET=your_production_secret
   

2. Increase rate limits:

   RATE_LIMIT_REQUESTS=50
   CACHE_TTL_MINUTES=15
   

3. Enable booking capabilities:

   • Flight orders and cancellations
   • Hotel booking (where available)
   • Transfer bookings

API Documentation

For detailed API information:

• Amadeus API Reference
• SDK Documentation
• Model Context Protocol

Support

• GitHub Issues: Report bugs or request features
• Amadeus Support: API documentation and limits
• Claude Desktop: MCP integration guide

License

This project is open source and available under the MIT License.