MCP server for Travelpayouts API -- flight search, popular routes, price calendar.
SaferSkills independently audited travelpayouts-mcp (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
If you were looking for a way to have Claude or another AI assistant find the cheapest flight on a route, show a price calendar across flexible dates, resolve an airport or airline code or search hotels, this is it. 13 tools sit on the Travelpayouts (Aviasales) API: flight search, price calendars, hotel search, airport/airline/city lookup, direct routes and flexible date pricing.
npm install -g @theyahia/travelpayouts-mcpOr use directly with npx:
npx @theyahia/travelpayouts-mcp| Variable | Required | Description |
|---|---|---|
TRAVELPAYOUTS_TOKEN | Yes | API token from Travelpayouts |
{
"mcpServers": {
"travelpayouts": {
"command": "npx",
"args": ["-y", "@theyahia/travelpayouts-mcp"],
"env": {
"TRAVELPAYOUTS_TOKEN": "your-token"
}
}
}
}| Tool | Description |
|---|---|
search_flights_prices | Search cheap flights by route, dates, and currency |
get_cheapest_month | Find cheapest flights for an entire month |
get_calendar_prices | Price calendar showing cheapest price per day |
get_popular_directions | Popular flight directions from a city with prices |
get_airline_directions | Routes served by a specific airline |
get_special_offers | Current special flight deals across all routes |
get_direct_routes | Search only non-stop flights between two cities |
get_nearest_prices | Prices for ±N days around a target date (flexible travel) |
| Tool | Description |
|---|---|
search_hotels | Search hotels by city with dates and guest count |
get_hotel_prices | Get prices for a specific hotel by ID |
| Tool | Description |
|---|---|
lookup_airports | Search/autocomplete airports by name or IATA code |
lookup_airlines | Search airlines by name or IATA/ICAO code |
lookup_cities | Search/autocomplete cities by name or IATA code |
API token passed via X-Access-Token header or query parameter. Retries on 429 (rate limit) and 5xx (server errors) with exponential backoff.
Uses lookup_cities to resolve IATA codes, then get_cheapest_month to find the best deals for the month.
Uses get_popular_directions with origin LED to show trending routes and current prices.
Uses search_hotels for accommodation options, then search_flights_prices for matching flight dates.
Uses get_nearest_prices to compare prices across 7 dates centered on March 15.
Uses get_direct_routes with direct=true filter.
npm install
npm run dev # Run with tsx
npm test # Run tests
npm run build # Compile TypeScriptMIT
Telegram: @vhodvai
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.