# Flight Search

> Flight Search is an open-source MCP server for maps and travel. Search Google Flights via SerpApi by IATA code, one-way or round trip. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/arjunprabhulal/mcp-flight-search
- **MCP Registry name:** io.github.arjunprabhulal/mcp-flight-search
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

This is a small Python server that wraps SerpApi's Google Flights API. It exposes a single search tool plus a status check, so an assistant can compare fares between two airports. You give origin and destination as IATA codes such as ATL or LAX, an outbound date in YYYY-MM-DD form and optionally a return date for a round trip.

Results are structured and include airline, price in USD, duration, stops, departure, arrival and cabin class. A SerpApi key is required in SERP_API_KEY; the README notes SerpApi has a free tier. The key is never logged.

It runs over stdio by default via uvx or pip, or as Streamable HTTP on a port you choose, and also ships a Docker image. Python 3.10 or later is needed, and the licence is MIT.

## Features

- **Flight search:** Finds one-way and round-trip flights between two airports.
- **IATA code input:** Takes airport codes such as ATL and LAX.
- **Structured results:** Returns airline, price, duration, stops, times and cabin class.
- **stdio or HTTP:** Run over stdio or as Streamable HTTP on a local port.
- **Docker image:** Container build is included.
- **Status tool:** server_status reports that the server is up and its version.

## Good for

- Compare fares for a route on a given date
- Check round-trip prices before planning a trip
- Let an assistant list stops and durations for options
- Add flight lookup to a travel-planning agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-flight-search --env SERP_API_KEY='<SERP_API_KEY>' -- uvx mcp-flight-search
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-flight-search": {
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-flight-search": {
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-flight-search": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-flight-search": {
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-flight-search": {
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_flights_tool`: Searches flights between two airports by IATA code and date, one-way or round trip
- `server_status`: Checks the server is running and reports its version

## FAQ

### Do I need an API key?

Yes. A SerpApi key in SERP_API_KEY is required; SerpApi has a free tier.

### Which Python versions?

Python 3.10 or later.

### How do I run it over HTTP?

Run mcp-flight-search --connection_type http --port 3001.

### What currency are prices in?

US dollars.

### Is Flight Search free?

Yes. Flight Search is open source, so you can use and self-host it for free.

### How do I add Flight Search to Claude Code?

Run this command in your terminal: claude mcp add mcp-flight-search --env SERP_API_KEY='<SERP_API_KEY>' -- uvx mcp-flight-search

### What are the best alternatives to Flight Search?

The closest alternatives to Flight Search are Atli, CAD2GIS, Coordinates, Photon and Travel Advisories.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Atli](https://ai-powered.com/mcp/atli): Atli is a free MCP server for maps and travel.
- [CAD2GIS](https://ai-powered.com/mcp/cad2gis): CAD2GIS is an open-source MCP server for engineering simulation.
- [Coordinates](https://ai-powered.com/mcp/coordinates): Coordinates is a freemium MCP server for maps and travel.
- [Photon](https://ai-powered.com/mcp/photon): Photon is a freemium MCP server for maps and travel.
- [Travel Advisories](https://ai-powered.com/mcp/travel-advisories): Travel Advisories is a freemium MCP server for maps and travel.
- [Sunvane Golden Hour](https://ai-powered.com/mcp/sunvane-golden-hour): Sunvane Golden Hour is an MCP server for maps and travel.
- [Openrouteservice](https://ai-powered.com/mcp/openrouteservice): Openrouteservice is a freemium MCP server for maps and travel.
- [Geodistance](https://ai-powered.com/mcp/geodistance): Geodistance is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/flight-search
