travelpayouts-mcp

MCP server for the Travelpayouts (Aviasales) API. 11 tools for flight search, price calendars, hotel search, and airport/airline/city lookup.

npm install -g @theyahia/travelpayouts-mcp

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

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

1. "Find the cheapest flights from Moscow to Istanbul in June"

Us