English Français العربية

Aviasales

Official registry Search and web

Cheap flight search via Aviasales Data API: fares by route, price calendar, cheapest destinations.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package avia-mcp
Claude Code 
claude mcp add aviasales -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -e 'AVIA_CURRENCY=rub' -- npx -y avia-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aviasales": {
            "command": "npx",
            "args": [
                "-y",
                "avia-mcp@0.1.1"
            ],
            "env": {
                "TRAVELPAYOUTS_TOKEN": "<your travelpayouts_token>",
                "AVIA_CURRENCY": "rub"
            }
        }
    }
}

Environment variables

  • TRAVELPAYOUTS_TOKEN required secret Travelpayouts API token (free: travelpayouts.com → Tools → API)
  • AVIA_CURRENCY Price currency, e.g. rub, usd, eur

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. avia-mcp
  2. Инструменты
  3. Токен
  4. Подключение
  5. Разработка
  6. Лицензия

avia-mcp

MCP-сервер для поиска дешёвых авиабилетов через Aviasales Data API (Travelpayouts).

Цены берутся из кэша поисков Aviasales примерно за 48 часов — это не живой поиск. Актуальную цену подтверждает ссылка на Aviasales из ответа. Покупки и бронирования через сервер нет.

Инструменты

ИнструментЧто делает
search_placesIATA-код города или аэропорта по названию. Токен не нужен.
search_flightsСамые дешёвые билеты по маршруту на дату или месяц.
price_calendarМинимальная цена по дням месяца и три самых дешёвых дня.
cheapest_destinationsСамые дешёвые направления из города, с потолком цены.

Токен

Бесплатный токен: travelpayouts.com → «Инструменты» → API. Без токена работает только search_places.

Подключение

Нужен Node.js 22 или новее. Сервер запускается через npx, ставить вручную ничего не надо.

Claude Code:

claude mcp add avia --scope user -e TRAVELPAYOUTS_TOKEN=ваш_токен -- npx -y avia-mcp

Claude Desktop, Cursor и другие клиенты — в конфиге MCP-серверов (для Claude Desktop это claude_desktop_config.json):

{
  "mcpServers": {
    "avia": {
      "command": "npx",
      "args": ["-y", "avia-mcp"],
      "env": { "TRAVELPAYOUTS_TOKEN": "ваш_токен" }
    }
  }
}
Переменные окружения
ПеременнаяПо умолчаниюЧто задаёт
TRAVELPAYOUTS_TOKEN—Токен Travelpayouts.
AVIA_CURRENCYrubВалюта цен.

Разработка

git clone https://github.com/danyasnov/avia-mcp.git
cd avia-mcp
npm install
npm run build
cp .env.example .env   # впишите токен

При запуске из клона сервер читает .env в корне проекта; переменные окружения процесса важнее файла. Подключить локальную сборку:

claude mcp add avia --scope user -- node /путь/к/avia-mcp/dist/index.js
Проверка
npm test
npm run smoke

npm run smoke запускает собранный сервер и вызывает каждый инструмент по разу. Без токена отвечает только search_places, остальные возвращают подсказку про токен.

Лицензия

MIT

Frequently asked questions

What is Aviasales?

Cheap flight search via Aviasales Data API: fares by route, price calendar, cheapest destinations.

How do I install Aviasales?

It runs on your machine. In Claude Code: claude mcp add aviasales -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -e 'AVIA_CURRENCY=rub' -- npx -y avia-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Aviasales need an API key?

Yes. It expects TRAVELPAYOUTS_TOKEN, which you set in its configuration.

Is Aviasales open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Aviasales?

It is published by danyasnov. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.