Travel MCP Server

A comprehensive Model Context Protocol (MCP) server for travel aggregation, providing AI assistants with access to flight search, hotel booking, airport information, and real-time flight tracking.

Quick Links

• Quick Start Guide - Get started in 5 minutes

• API Documentation - See all available tools

• Troubleshooting - Common issues and solutions

Features

Flight Search & Booking

• Search Flights: Find flight offers between airports with prices, airlines, and schedules

• Find Cheapest Dates: Discover the most affordable travel dates for flexible planning

• Flight Tracking: Real-time flight status, location, altitude, and ETA

Hotel Search

• Search Hotels: Find hotels with availability, pricing, amenities, and location

• Multi-city Support: Search hotels in any city worldwide

Airport Information

• Airport Search: Find airports by city name or location

• Airport Details: Get comprehensive airport information including timezone and facilities

• Route Information: View all flights between two airports

APIs Used

Primary: Amadeus Self-Service API

• Flight Offers Search

• Hotel Search

• Airport & City Search

• Cheapest Date Search

Get your Amadeus API keys (Free tier available with monthly quota)

Secondary: AviationStack API

• Real-time Flight Tracking

• Flight Status Updates

• Route Information

Get your AviationStack API key (100 free requests/month)

Installation

Prerequisites

• Python 3.10 or higher

• pip package manager

Setup Steps

1. Clone the repository

2. Create a virtual environment

3. Install dependencies

4. Set up environment variables

Edit the .env file with your API credentials:

Getting API Keys

Amadeus API

1. Go to Amadeus for Developers

2. Click "Register" to create an account

3. Go to "My Self-Service Workspace"

4. Click "Create New App"

5. Copy your API Key and API Secret

AviationStack (Optional)

1. Go to AviationStack

2. Sign up for a free account

3. Copy your API key from the dashboard

Usage with Claude Desktop

Configuration

Add this to your Claude Desktop config file:

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

Restart Claude Desktop

After adding the configuration, restart Claude Desktop to load the MCP server.

Available Tools

1. search_flights

Search for flight offers between two airports.

Parameters:

• origin (required): Origin airport IATA code (e.g., 'JFK')

• destination (required): Destination airport IATA code (e.g., 'LAX')

• departure_date (required): Departure date (YYYY-MM-DD)

• return_date (optional): Return date (YYYY-MM-DD)

• adults (optional): Number of passengers (default: 1)

• max_results (optional): Max results to return (default: 10)

Example:

2. search_hotels

Search for hotels in a city with availability and pricing.

Parameters:

• city_code (required): City IATA code (e.g., 'NYC', 'PAR')

• check_in_date (required): Check-in date (YYYY-MM-DD)

• check_out_date (required): Check-out date (YYYY-MM-DD)

• adults (optional): Number of guests (default: 1)

Example:

3. search_airports

Search for airports by city name.

Parameters:

• city_name (required): Name of the city

Example:

4. find_cheapest_dates

Find the cheapest dates to fly between two airports.

Parameters:

• origin (required): Origin airport IATA code

• destination (required): Destination airport IATA code

Example:

5. track_flight

Track a flight in real-time (requires AviationStack API key).

Parameters:

• flight_iata or flight_icao (one required): Flight code

Example:

6. get_flights_by_route

Get all flights on a specific route.

Parameters:

• dep_iata (optional): Departure airport IATA code

• arr_iata (optional): Arrival airport IATA code

Example:

7. get_airport_info

Get detailed information about an airport.

Parameters:

• iata_code (required): Airport IATA code

Example:

Common Airport Codes

• JFK - New York John F. Kennedy

• LAX - Los Angeles International

• LHR - London Heathrow

• CDG - Paris Charles de Gaulle

• NRT - Tokyo Narita

• DXB - Dubai International

• SYD - Sydney Airport

• SFO - San Francisco International

Development

Running Tests

Code Formatting

Type Checking

API Rate Limits

Amadeus Free Tier

• Test Environment: Fixed monthly quota

• Production: Free monthly quota + pay-as-you-go

AviationStack Free Tier

• 100 API calls per month

• 30-60 second data delay

Troubleshooting

"AMADEUS_CLIENT_ID and AMADEUS_CLIENT_SECRET must be set"

• Ensure you've created a .env file with your credentials

• Or set them in your Claude Desktop config

"Unknown tool" error

• Check that your API keys are valid

• Ensure clients are initialized (check server logs)

API Rate Limit Exceeded

• Amadeus: Wait for monthly quota reset or upgrade plan

• AviationStack: Wait for monthly reset or upgrade plan

Contributing

Contributions welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your projects!

Support

For issues and questions:

• Open an issue on GitHub

• Check the Amadeus API Documentation

• Check the AviationStack Documentation

Roadmap

• Add price alerts and monitoring

• Add car rental search

• Add train/rail search (Eurail, Amtrak)

• Add activity/tour booking

• Add travel insurance options

• Add visa requirement checker

• Add currency converter

• Add weather forecasts for destinations

• Add caching for repeated queries

• Add more travel APIs (Booking.com, Expedia)

Acknowledgments

Built with:

• Model Context Protocol

• Amadeus for Developers

• AviationStack

Happy Traveling! ✈️ 🏨 🌍