jessalva7/flight-search-mcp-server

Flight Search MCP Server

A FastMCP server that enables AI assistants to search for flights between airports using the SearchAPI.io Google Flights API. Get real-time flight prices, schedules, airlines, and carbon emissions data through a simple MCP tool interface.

Setup

1. Create and activate virtual environment:

uv venv
source .venv/bin/activate

2. Install dependencies:

uv add fastmcp httpx

3. Set your API key (optional, defaults to the one provided):

export SEARCHAPI_KEY="your_api_key_here"

Usage

Test with FastMCP dev mode:

fastmcp dev server.py

Or run directly:

fastmcp run server.py

Available Tools

search_flights

Search for flights between airports with specified dates.

Parameters:

• departure_id (required): Departure airport code (e.g., JFK, LAX)
• arrival_id (required): Arrival airport code (e.g., MAD, LHR)
• outbound_date (required): Outbound date in YYYY-MM-DD format
• return_date (optional): Return date in YYYY-MM-DD format
• flight_type (optional): "round_trip" or "one_way" (default: round_trip)

Example:

{
  "departure_id": "JFK",
  "arrival_id": "MAD",
  "outbound_date": "2025-11-02",
  "return_date": "2025-11-09",
  "flight_type": "round_trip"
}

MCP Configuration

Add to your .kiro/settings/mcp.json:

{
  "mcpServers": {
    "flight-search": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "SEARCHAPI_KEY": "your_api_key_here"
      }
    }
  }
}