Skip to content
MCP server

Aviasales

Find cheap flights, price calendars and cheapest destinations via Aviasales data

Runs locallyStatus and history
Install
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-mcp

Add 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)Required
  • AVIA_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.

How AIPoweredBot checks servers