Travelpayouts Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Travelpayouts (Aviasales) MCP server that lets an assistant search flights, price calendars and hotels and look up airports, airlines and cities.

What you can do
  • Search flights by route, dates and currency, including cheapest-month, price-calendar, nearest-date and non-stop-only options
  • Browse popular directions, airline routes and current special deals
  • Search hotels by city with dates and guest count, and fetch prices for a specific hotel
  • Look up and autocomplete airports, airlines and cities by name or IATA/ICAO code
When to use it
Useful when you want an assistant to compare airfares across flexible dates, find cheap or direct routes, check popular destinations, or pair hotel options with matching flights.
Requirements
Runs locally over stdio, typically via npx or a global npm install, so Node.js is needed. Requires a Travelpayouts API token supplied in the TRAVELPAYOUTS_TOKEN environment variable. Network access to the Travelpayouts API is required.
Before you install
The Travelpayouts API token is a secret passed in the environment; keep it out of shared configs and logs. Queries and travel searches are sent to the third-party Travelpayouts/Aviasales API, and results may include affiliate or partner links. The server only reads price data; it does not book or pay for travel.

Installation

In SourceWeft

  1. Open Travelpayouts Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npm install -g @theyahia/travelpayouts-mcp

Or use directly with npx:

bash
npx @theyahia/travelpayouts-mcp

Environment Variables

VariableRequiredDescription
TRAVELPAYOUTS_TOKENYesAPI token from Travelpayouts

Claude Desktop Config

json
{  "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

bash
npm installnpm run dev          # Run with tsxnpm test             # Run testsnpm run build        # Compile TypeScript

License

MIT

Telegram: @vhodvai

Source: README.md at commit 9cc3a56

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts