English Français العربية

io.github.theYahia/travelpayouts-mcp

السجل الرسمي البحث والويب

MCP server for Travelpayouts API -- flight search, popular routes, price calendar.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/travelpayouts-mcp
Claude Code 
claude mcp add travelpayouts-mcp -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -- npx -y @theyahia/travelpayouts-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "travelpayouts-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/travelpayouts-mcp@1.0.0"
            ],
            "env": {
                "TRAVELPAYOUTS_TOKEN": "<your travelpayouts_token>"
            }
        }
    }
}

متغيرات البيئة

  • TRAVELPAYOUTS_TOKEN إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Travelpayouts MCP — flight and hotel search for AI assistants
  2. Install
  3. Environment Variables
  4. Claude Desktop Config
  5. Tools (13)
  6. Auth
  7. Demo Prompts
  8. Development
  9. License

Travelpayouts MCP — flight and hotel search for AI assistants

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.

Install

npm install -g @theyahia/travelpayouts-mcp

Or use directly with npx:

npx @theyahia/travelpayouts-mcp

Environment Variables

VariableRequiredDescription
TRAVELPAYOUTS_TOKENYesAPI token from Travelpayouts

Claude Desktop Config

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

Tools (13)

Flights (8)
ToolDescription
search_flights_pricesSearch cheap flights by route, dates, and currency
get_cheapest_monthFind cheapest flights for an entire month
get_calendar_pricesPrice calendar showing cheapest price per day
get_popular_directionsPopular flight directions from a city with prices
get_airline_directionsRoutes served by a specific airline
get_special_offersCurrent special flight deals across all routes
get_direct_routesSearch only non-stop flights between two cities
get_nearest_pricesPrices for ±N days around a target date (flexible travel)
Hotels (2)
ToolDescription
search_hotelsSearch hotels by city with dates and guest count
get_hotel_pricesGet prices for a specific hotel by ID
Lookup (3)
ToolDescription
lookup_airportsSearch/autocomplete airports by name or IATA code
lookup_airlinesSearch airlines by name or IATA/ICAO code
lookup_citiesSearch/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.
  4. "I want to fly Moscow → Dubai around March 15, but ±3 days is fine if it's cheaper" Uses get_nearest_prices to compare prices across 7 dates centered on March 15.
  5. "Find only direct flights from Moscow to Minsk" Uses get_direct_routes with direct=true filter.

Development

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

License

MIT

Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/travelpayouts-mcp؟

MCP server for Travelpayouts API -- flight search, popular routes, price calendar.

كيف أثبّت io.github.theYahia/travelpayouts-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add travelpayouts-mcp -e 'TRAVELPAYOUTS_TOKEN=<your travelpayouts_token>' -- npx -y @theyahia/travelpayouts-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/travelpayouts-mcp إلى مفتاح API؟

نعم. يتطلب TRAVELPAYOUTS_TOKEN، وتضبطها في إعداداته.

هل io.github.theYahia/travelpayouts-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/travelpayouts-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.