Flight Search

io.github.arjunprabhulalPublished by GitHub account arjunprabhulalv0.3.0Updated Oct 24, 2026

Search Google Flights through SerpApi: one-way and round-trip flights by IATA airport code.

Overview

AI-generated overview

A local MCP server that searches Google Flights via SerpApi, returning one-way and round-trip options by IATA airport code.

What you can do
Search flights between two airports by IATA code, with optional return date for round trips, returning airline, price in USD, duration, stops, departure and arrival times, and cabin class. Check server status and version.
When to use it
Useful when an assistant should look up flight options and prices for a trip between two airports, for example comparing one-way or round-trip itineraries before booking elsewhere.
Requirements
Runs locally as a Python package (Python 3.10+ or uv, launched with uvx or pip install) or via Docker. Requires a SerpApi key supplied in the SERP_API_KEY environment variable and network access to SerpApi.
Before you install
The SerpApi key is a secret passed in SERP_API_KEY; keep it out of shared configs. Queries and airport codes are sent to SerpApi, and usage may count against your SerpApi plan or quota. Results are read-only lookups; no bookings are made.

Installation

In SourceWeft

  1. Open Flight Search in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP Flight Search

An MCP server that searches Google Flights through SerpApi, for Claude, Cursor and other MCP clients. One-way and round-trip searches by IATA airport code, with prices, durations, stops and times.

[CI] [PyPI]

Requirements

  • Python 3.10 or later (or uv)
  • A SerpApi key in SERP_API_KEY (serpapi.com has a free tier)

Use it from an MCP client

Add it to your client's MCP configuration (Claude Desktop, Claude Code, Cursor, ...):

json
{  "mcpServers": {    "flight-search": {      "command": "uvx",      "args": ["mcp-flight-search"],      "env": { "SERP_API_KEY": "your-serpapi-key" }    }  }}

Or install it with pip install mcp-flight-search and use "command": "mcp-flight-search".

Run it yourself

bash
export SERP_API_KEY="your-serpapi-key"mcp-flight-search                                    # stdio (default)mcp-flight-search --connection_type http --port 3001 # Streamable HTTP at http://127.0.0.1:3001/mcp

LOG_LEVEL=DEBUG shows more detail on stderr. The API key is never logged.

With Docker:

bash
docker build -t mcp-flight-search .docker run -i --rm -e SERP_API_KEY=your-serpapi-key mcp-flight-search

Tools

ToolWhat it does
search_flights_toolFlights between two airports. origin, destination: IATA codes such as ATL, LAX. outbound_date: YYYY-MM-DD. return_date (optional): YYYY-MM-DD for a round trip. Returns structured results: airline, price (USD), duration, stops, departure, arrival, cabin class.
server_statusChecks the server is running and reports its version.

Development

bash
uv syncuv run pytestuv run ruff check .

License

MIT

Source: README.md at commit c379625

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.0LatestOct 15, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts