1. Conduid
  2. Search
  3. io.github.theYahia/travelpayouts-mcp
MCP server · Search

io.github.theYahia/travelpayouts-mcp

by · github.com/theYahia/travelpayouts-mcp

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

Unclaimed search
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.theYahia/travelpayouts-mcp

io.github.theYahia/travelpayouts-mcp is an MCP server published by theYahia in the Search category: mCP server for Travelpayouts API -- flight search, popular routes, price calendar.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-theyahia-travelpayouts-mcp -- npx -y @theyahia/travelpayouts-mcp
npx
npx -y @theyahia/travelpayouts-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (8)

get_airline_directionsRoutes served by a specific airline

Parameters not published.

get_calendar_pricesPrice calendar showing cheapest price per day

Parameters not published.

get_cheapest_monthFind cheapest flights for an entire month

Parameters not published.

get_direct_routesSearch only non-stop flights between two cities

Parameters not published.

get_nearest_pricesPrices for ±N days around a target date (flexible travel)

Parameters not published.

get_popular_directionsPopular flight directions from a city with prices

Parameters not published.

get_special_offersCurrent special flight deals across all routes

Parameters not published.

search_flights_pricesSearch cheap flights by route, dates, and currency

Parameters not published.

Ask AI

✦

Ask AI about io.github.theYahia/travelpayouts-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.theYahia/travelpayouts-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@theyahia/travelpayouts-mcp

MCP server for the Travelpayouts (Aviasales) API. 13 tools for 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

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 (13)

Flights (8)

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
get_direct_routes Search only non-stop flights between two cities
get_nearest_prices Prices for ±N days around a target date (flexible travel)

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.

  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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.theYahia/travelpayouts-mcp

How do I install io.github.theYahia/travelpayouts-mcp?

Run claude mcp add io-github-theyahia-travelpayouts-mcp -- npx -y @theyahia/travelpayouts-mcp, then add the server to your MCP client's configuration.

Is io.github.theYahia/travelpayouts-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.theYahia/travelpayouts-mcp still maintained?

Yes — the last commit was a month ago. The repository has 0 stars and 1 forks.