Travelpayouts MCP

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (13)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Travelpayouts MCP.

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

Documentation Overview

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

Terminal

npm install -g @theyahia/travelpayouts-mcp

Or use directly with npx:

Terminal

npx @theyahia/travelpayouts-mcp

Environment Variables

Variable	Required	Description
`TRAVELPAYOUTS_TOKEN`	Yes	API token from Travelpayouts

Claude Desktop Config

config.json

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

"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.
"What are the popular destinations from Saint Petersburg right now?" Uses get_popular_directions with origin LED to show trending routes and current prices.
"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.
"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.
"Find only direct flights from Moscow to Minsk" Uses get_direct_routes with direct=true filter.

Development

Terminal

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

License

MIT

Telegram: @vhodvai

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

3d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Travelpayouts MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "travelpayouts-mcp": { "command": "npx", "args": ["-y", "travelpayouts-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Travelpayouts MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/travelpayouts-mcp?style=directory)](https://allmcps.com/mcp/travelpayouts-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/travelpayouts-mcp"><img src="https://allmcps.com/api/badge/travelpayouts-mcp?style=directory" alt="Travelpayouts MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

52Quality signal: Good · 52/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Travelpayouts MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Documentation Overview

Travelpayouts MCP — flight and hotel search for AI assistants

Install

Terminal

npm install -g @theyahia/travelpayouts-mcp

Or use directly with npx:

Terminal

npx @theyahia/travelpayouts-mcp

Environment Variables

Variable	Required	Description
`TRAVELPAYOUTS_TOKEN`	Yes	API token from Travelpayouts

Claude Desktop Config

config.json

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

"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.
"What are the popular destinations from Saint Petersburg right now?" Uses get_popular_directions with origin LED to show trending routes and current prices.
"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.
"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.
"Find only direct flights from Moscow to Minsk" Uses get_direct_routes with direct=true filter.

Development

Terminal

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

License

MIT

Telegram: @vhodvai

Frequently Asked Questions about Travelpayouts MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "travelpayouts-mcp": { "command": "npx", "args": ["-y", "travelpayouts-mcp"] } }