Aviasales
Find cheap flights, price calendars and cheapest destinations via Aviasales data
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Aviasales
Aviasales is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
This server queries the Aviasales Data API from Travelpayouts, so prices come from a cache of Aviasales searches from roughly the last 48 hours rather than a live search. Each answer includes an Aviasales link that confirms the current fare, and the server does not buy or book anything. The README is written in Russian.
Four tools are provided. search_places turns a city or airport name into an IATA code and needs no token. search_flights lists the cheapest tickets on a route for a date or month. price_calendar gives the minimum price for each day of a month and the three cheapest days. cheapest_destinations lists the cheapest places to fly from a city under a price ceiling.
A free Travelpayouts token is required for everything except place lookup. Prices default to roubles, and AVIA_CURRENCY switches them to usd, eur or others. It needs Node.js 22 or newer, starts through npx and is MIT licensed.
Install
Run in a terminal
claude mcp add avia-mcp --env TRAVELPAYOUTS_TOKEN='<TRAVELPAYOUTS_TOKEN>' -- npx -y avia-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"avia-mcp": {
"command": "npx",
"args": [
"-y",
"avia-mcp"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"avia-mcp": {
"command": "npx",
"args": [
"-y",
"avia-mcp"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"avia-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"avia-mcp"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"avia-mcp": {
"command": "npx",
"args": [
"-y",
"avia-mcp"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"avia-mcp": {
"command": "npx",
"args": [
"-y",
"avia-mcp"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TRAVELPAYOUTS_TOKENTravelpayouts API token (free: travelpayouts.com → Tools → API)RequiredAVIA_CURRENCYPrice currency, e.g. rub, usd, eur
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- search_places
- Finds the IATA code for a city or airport by name
- search_flights
- Finds the cheapest tickets on a route for a date or month
- price_calendar
- Minimum price per day of a month and the three cheapest days
- cheapest_destinations
- Cheapest destinations from a city under a price ceiling
What it does
- Cheapest fares
- Lists the lowest-priced tickets on a route for a date or month.
- Price calendar
- Shows the minimum price per day and the three cheapest days.
- Cheapest destinations
- Finds low-fare places to fly from a city under a price cap.
- Place lookup
- Converts city or airport names to IATA codes without a token.
- Currency setting
- Prices default to rub and can be set to usd, eur and others.
- Link to confirm price
- Each result links to Aviasales for the current price.
Good for
- Find the cheapest day to fly in a given month
- Look up IATA codes for a city
- Discover cheap destinations within a budget
- Compare fares across a route's dates
Pricing
Open source
Free, MIT; needs a free Travelpayouts token
Aviasales FAQ
Are prices live?
No. They come from an Aviasales search cache of about 48 hours, and the link confirms the current price.
Can it book tickets?
No. It has no purchase or booking function.
Do I need a token?
A free Travelpayouts token is needed for all tools except search_places.
Which currency does it use?
Roubles by default; set AVIA_CURRENCY for another.
Is Aviasales free?
Yes. Aviasales is open source, so you can use and self-host it for free.
How do I add Aviasales to Claude Code?
Run this command in your terminal: claude mcp add avia-mcp --env TRAVELPAYOUTS_TOKEN='<TRAVELPAYOUTS_TOKEN>' -- npx -y avia-mcp
What are the best alternatives to Aviasales?
The closest alternatives to Aviasales 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.
