@theyahia/travelpayouts-mcp

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

Install

npm install -g @theyahia/travelpayouts-mcp

Or use directly with npx:

npx @theyahia/travelpayouts-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TRAVELPAYOUTS_TOKEN | Yes | API token from Travelpayouts |

Claude Desktop Config

{
  "mcpServers": {
    "travelpayouts": {
      "command": "npx",
      "args": ["-y", "@theyahia/travelpayouts-mcp"],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "your-token"
      }
    }
  }
}

Tools (11)

Flights (6)

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

Hotels (2)

| Tool | Description | |------|-------------| | search_hotels | Search hotels by city with dates and guest count | | get_hotel_prices | Get prices for a specific hotel by ID |

Lookup (3)

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

Auth

API token passed via X-Access-Token header or query parameter. Retries on 429 (rate limit) and 5xx (server errors) with exponential backoff.

Demo Prompts

1. "Find the cheapest flights from Moscow to Istanbul in June" Uses lookup_cities to resolve IATA codes, then get_cheapest_month to find the best deals for the month.

2. "What are the popular destinations from Saint Petersburg right now?" Uses get_popular_directions with origin LED to show trending routes and current prices.

3. "Search hotels in Sochi for July 10-17 for 2 adults, then find flights there from Moscow" Uses search_hotels for accommodation options, then search_flights_prices for matching flight dates.

Development

npm install
npm run dev          # Run with tsx
npm test             # Run tests
npm run build        # Compile TypeScript

License

MIT