Price Per TokenPrice Per Token
Amadeus Flight Search Server

Amadeus Flight Search Server

by almogqwinz

GitHub 1 367 uses Remote
0

About

Amadeus Flight Search Server integrates with the Amadeus Flight Offers Search API to provide real-time flight search capabilities through natural language interfaces. Key features: - Search for flights between any two locations with specific travel dates - Retrieve comprehensive flight details including departure/arrival times, airline information, and pricing - Specify passenger count and preferences for tailored search results - Supports both test and production Amadeus API endpoints via configurable environment - Built on the official amadeus-python SDK for reliable API communication

README

Amadeus MCP Server

[](https://smithery.ai/server/@donghyun-chae/mcp-amadeus)

MCP-Amadeus is a community-developed Model Context Protocol (MCP) server that integrates with the Amadeus Flight Offers Search API to provide flight search capabilities through natural language interfaces. Built for use with MCP-compatible clients (e.g., Claude Desktop).

This project enables users to easily search for flight options between two locations with specific dates using the power of large language models (LLMs) and the Amadeus API.

This project uses the official amadeus-python SDK

> Disclaimer: This is an open-source project *not affiliated with or endorsed by Amadeus IT Group.* Amadeus® is a registered trademark of Amadeus IT Group.

---

✨ Features

✈️ Flight Offers Search

Retrieve flight options between two locations for specified dates.

> "I'm looking for nonstop flights from New York to London on June 15th, any airline, for 1 adult." > → ✈️ Returns available flight options with details like departure time, arrival time, airline, and price.

  • Powered by Amadeus Flight Offers Search API
  • Configurable test/production endpoints
  • Requires origin, destination, number of tickets and travel date input
  • ---

    🌐 Demo

    Once installed and connected to an MCP-compatible client (e.g., Claude Desktop), this server exposes tools that your AI assistant can use to fetch flight data.

    ---

    🚀 Quick Start

    Installing via Smithery

    To install Amadeus MCP Server for Claude Desktop automatically via Smithery:

    npx -y @smithery/cli install @donghyun-chae/mcp-amadeus --client claude
    

    1. Clone and Setup

    `` bash git clone https://github.com/donghyun-chae/mcp-amadeus.git cd mcp-amadeus-flight-offers

    Install dependencies (using uv or pip)

    uv sync
    
    

    2. Get Your API Key and Set Environment

    bash cp .env.example .env
    Then edit .env and add your API credentials:

    bash AMADEUS_CLIENT_ID=your_client_id AMADEUS_CLIENT_SECRET=your_client_secret AMADEUS_HOSTNAME=test
    
    Configuration Options:
    
  • AMADEUS_CLIENT_ID: Your Amadeus API Client ID
  • AMADEUS_CLIENT_SECRET: Your Amadeus API Client Secret
  • AMADEUS_HOSTNAME: API endpoint to use - test for testing (default) or production for live API
  • Sign up on https://developers.amadeus.com/ and create an app to obtain your Client ID and Client Secret.

    🌐 Environment Configuration

    The server supports both test and production Amadeus API endpoints:

  • Test Environment (AMADEUS_HOSTNAME=test): Use this for development and testing. The test environment provides:
  • - Free API access with test data - No charges for API requests - Limited to test flight data

  • Production Environment (AMADEUS_HOSTNAME=production): Use this for live applications. The production environment provides:
  • - Real, live flight data - Pay-per-request pricing - Full access to all Amadeus services

    > ⚠️ Important: Always use the test environment during development. Switch to production only when your application is ready for live data and you understand the associated costs.

    3. Configure MCP Client

    Register this server in your MCP client (e.g., Claude for Desktop).

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

    bash { "mcpServers": { "amadeus": { "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/", "run", "--env-file", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env", "server.py" ] } } }
    
    > Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/ with the actual path to your project folder.

    my case:

    bash { "mcpServers": { "amadeus": { "command": "/Users/asena/.local/bin/uv", "args": [ "--directory", "/Users/asena/mcp-amadeus/src/", "run", "--env-file", "/Users/asena/mcp-amadeus/.env", "server.py" ] } } }

    
    ---

    🛠️ Tools

    After installation, the following tool is exposed to MCP clients:

    search_flight_offers

    Retrieves flight offers from the Amadeus Flight Offers Search API. The API endpoint (test/production) is configurable via the AMADEUS_HOSTNAME` environment variable.

    Request:

    json { "action": "tool", "name": "search_flight_offers", "params": { "originLocationCode": "JFK", "destinationLocationCode": "LHR", "depa

    Related MCP Servers

    AI Research Assistant

    AI Research Assistant

    hamid-vakilzadeh

    AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

    Web & Search
    12 8
    Linkup

    Linkup

    LinkupPlatform

    Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages

    Web & Search
    2 24
    Math-MCP

    Math-MCP

    EthanHenrickson

    Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support

    Developer Tools
    22 81