Aviasales Flight Prices MCP server

aviasales-mcp

<!-- mcp-name: io.github.stufently/aviasales-mcp -->

MCP server for flight price search via Aviasales / Travelpayouts Data API. Thirteen read-only tools that let Claude Code, Claude Desktop, Cursor or any other MCP client answer flight-price questions: fares by route and month, the cheapest day to fly, flexible dates, budget and inspiration search, plus airport/city/airline lookup.

Unlike Google-Flights-scraping MCP servers, place names do not have to be guessed into IATA codes by the model: lookupcities and findnearest_airports resolve them.

Common prompts

Ask your agent in plain language — it picks the tool.

Install

You need two things: Docker, and a free Travelpayouts API token from .

The server ships as a container image, ghcr.io/stufently/aviasales-mcp. Your MCP client starts it on demand, so there is nothing to install beyond pasting one block below. To check the image starts, send it one initialize — it should print a JSON reply naming the server, "name":"Aviasales". This does not test the token itself; a wrong one surfaces as an error on the first search:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"0"}}}' \
  | docker run -i --rm -e AVIASALES_API_TOKEN=your-token-here ghcr.io/stufently/aviasales-mcp:latest

:latest follows releases; pin a version tag (:0.5.0) if you would rather upgrade by hand. The package is also PyPI-ready; once it is on PyPI, uvx aviasales-mcp will work wherever docker run -i --rm … image does below.

MCP client configs

Every block runs the same command. -e AVIASALESAPITOKEN with no value hands the container the variable the client sets in env, so the token is written in exactly one place. AVIASALES_MARKET is optional but worth setting — see Configuration; delete it and its -e pair if you do not need it.

Keep the token out of anything you commit. A project-level .mcp.json,

.cursor/mcp.json or .zed/settings.json is a normal thing to check into git,

and a token pasted there goes with it. Prefer the user-level config file, or

.gitignore the project one.

Claude Code

claude mcp add --scope user aviasales -e AVIASALES_API_TOKEN=your-token-here -- \
  docker run -i --rm -e AVIASALES_API_TOKEN ghcr.io/stufently/aviasales-mcp:latest

--scope user makes it available in every project and keeps the token in ~/.claude.json, out of the repository. Check with claude mcp list.

Claude Desktop, Cursor, Windsurf

All three take the same mcpServers JSON; only the file differs:

Shortened. The full README is on GitHub.