# Aviasales

> Aviasales is an open-source MCP server for maps and travel. Find cheap flights, price calendars and cheapest destinations via Aviasales data. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add avia-mcp --env TRAVELPAYOUTS_TOKEN='<TRAVELPAYOUTS_TOKEN>' -- npx -y avia-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "avia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "avia-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## 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/aviasales
