Travel MCP Server

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

cd travel-mcp-server

2. Create a virtual environment

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies

pip install -e .

4. Set up environment variables

cp .env.example .env

Edit the .env file with your API credentials:

# Amadeus API Credentials (Required)
AMADEUS_CLIENT_ID=your_amadeus_api_key_here
AMADEUS_CLIENT_SECRET=your_amadeus_api_secret_here
AMADEUS_ENV=test  # Use 'production' when ready

# AviationStack API Key (Optional - for flight tracking)
AVIATIONSTACK_API_KEY=your_aviationstack_key_here

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

{
  "mcpServers": {
    "travel": {
      "command": "/path/to/travel-mcp-server/venv/bin/python",
      "args": [
        "-m",
        "travel_mcp.server"
      ],
      "env": {
        "AMADEUS_CLIENT_ID": "your_amadeus_api_key",
        "AMADEUS_CLIENT_SECRET": "your_amadeus_api_secret",
        "AMADEUS_ENV": "test",
        "AVIATIONSTACK_API_KEY": "your_aviationstack_key"
      }
    }
  }
}

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:

Find me flights from New York (JFK) to London (LHR) on December 25, 2025, returning January 5, 2026

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:

Find hotels in Paris for December 20-25, 2025 for 2 adults

3. search_airports

Search for airports by city name.

Parameters:

• city_name (required): Name of the city

Example:

What airports are in Tokyo?

4. fin