{
  "markdown": "# Travelpayouts MCP — flight and hotel search for AI assistants\n\nIf 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.\n\n## Install\n\n```bash\nnpm install -g @theyahia/travelpayouts-mcp\n```\n\nOr use directly with npx:\n\n```bash\nnpx @theyahia/travelpayouts-mcp\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `TRAVELPAYOUTS_TOKEN` | Yes | API token from [Travelpayouts](https://support.travelpayouts.com/hc/en-us/articles/203956173-API) |\n\n## Claude Desktop Config\n\n```json\n{\n  \"mcpServers\": {\n    \"travelpayouts\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/travelpayouts-mcp\"],\n      \"env\": {\n        \"TRAVELPAYOUTS_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n## Tools (13)\n\n### Flights (8)\n| Tool | Description |\n|------|-------------|\n| `search_flights_prices` | Search cheap flights by route, dates, and currency |\n| `get_cheapest_month` | Find cheapest flights for an entire month |\n| `get_calendar_prices` | Price calendar showing cheapest price per day |\n| `get_popular_directions` | Popular flight directions from a city with prices |\n| `get_airline_directions` | Routes served by a specific airline |\n| `get_special_offers` | Current special flight deals across all routes |\n| `get_direct_routes` | Search only non-stop flights between two cities |\n| `get_nearest_prices` | Prices for ±N days around a target date (flexible travel) |\n\n### Hotels (2)\n| Tool | Description |\n|------|-------------|\n| `search_hotels` | Search hotels by city with dates and guest count |\n| `get_hotel_prices` | Get prices for a specific hotel by ID |\n\n### Lookup (3)\n| Tool | Description |\n|------|-------------|\n| `lookup_airports` | Search/autocomplete airports by name or IATA code |\n| `lookup_airlines` | Search airlines by name or IATA/ICAO code |\n| `lookup_cities` | Search/autocomplete cities by name or IATA code |\n\n## Auth\n\nAPI token passed via `X-Access-Token` header or query parameter. Retries on 429 (rate limit) and 5xx (server errors) with exponential backoff.\n\n## Demo Prompts\n\n1. **\"Find the cheapest flights from Moscow to Istanbul in June\"**\n   Uses `lookup_cities` to resolve IATA codes, then `get_cheapest_month` to find the best deals for the month.\n\n2. **\"What are the popular destinations from Saint Petersburg right now?\"**\n   Uses `get_popular_directions` with origin LED to show trending routes and current prices.\n\n3. **\"Search hotels in Sochi for July 10-17 for 2 adults, then find flights there from Moscow\"**\n   Uses `search_hotels` for accommodation options, then `search_flights_prices` for matching flight dates.\n\n4. **\"I want to fly Moscow → Dubai around March 15, but ±3 days is fine if it's cheaper\"**\n   Uses `get_nearest_prices` to compare prices across 7 dates centered on March 15.\n\n5. **\"Find only direct flights from Moscow to Minsk\"**\n   Uses `get_direct_routes` with direct=true filter.\n\n## Development\n\n```bash\nnpm install\nnpm run dev          # Run with tsx\nnpm test             # Run tests\nnpm run build        # Compile TypeScript\n```\n\n## License\n\nMIT\n\n",
  "bytes": 3395,
  "sha": "e9c26e500821af99a8c0abf150a16a75a9572f58f45ed0f38d58c49a9a8d51ff",
  "repo_slug": "theyahia/travelpayouts-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_travelpayouts_mcp_8d613b12/readme"
}