Aviasales
Cheap flight search via Aviasales Data API: fares by route, price calendar, cheapest destinations.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
avia-mcpclaude mcp add aviasales -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -e 'AVIA_CURRENCY=rub' -- npx -y avia-mcp@0.1.1
{
"mcpServers": {
"aviasales": {
"command": "npx",
"args": [
"-y",
"avia-mcp@0.1.1"
],
"env": {
"TRAVELPAYOUTS_TOKEN": "<your travelpayouts_token>",
"AVIA_CURRENCY": "rub"
}
}
}
}
Variables d'environnement
TRAVELPAYOUTS_TOKENobligatoire secret Travelpayouts API token (free: travelpayouts.com → Tools → API)AVIA_CURRENCYPrice currency, e.g. rub, usd, eur
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
avia-mcp
MCP-сервер для поиска дешёвых авиабилетов через Aviasales Data API (Travelpayouts).
Цены берутся из кэша поисков Aviasales примерно за 48 часов — это не живой поиск. Актуальную цену подтверждает ссылка на Aviasales из ответа. Покупки и бронирования через сервер нет.
Инструменты
| Инструмент | Что делает |
|---|---|
search_places | IATA-код города или аэропорта по названию. Токен не нужен. |
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_CURRENCY | rub | Валюта цен. |
Разработка
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
Questions fréquentes
Qu'est-ce que Aviasales ?
Cheap flight search via Aviasales Data API: fares by route, price calendar, cheapest destinations.
Comment installer Aviasales ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add aviasales -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -e 'AVIA_CURRENCY=rub' -- npx -y avia-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Aviasales ?
Oui. Il attend TRAVELPAYOUTS_TOKEN, à renseigner dans sa configuration.
Aviasales est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Aviasales ?
Il est publié par danyasnov. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.