Is Travelpayouts free?

Yes, Travelpayouts is free to use.

How do I install Travelpayouts?

Travelpayouts is a local plugin. Install it using npm package: @theyahia/travelpayouts-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Travelpayouts need?

Travelpayouts requires the following credentials or environment variables: TRAVELPAYOUTS_TOKEN. You can find setup instructions on the server detail page.

What AI apps work with Travelpayouts?

Travelpayouts uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Travelpayouts MCP Server

by TheYahia

Developer ToolsModerate7.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

7.0

Moderate7.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

12 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

API key for the serviceRequired

Environment variable: TRAVELPAYOUTS_TOKEN

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub 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

"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

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Travelpayouts MCP Server

About

Security Report

Findings (4)Action required

Permissions Required

What You'll Need

How to Install

Documentation

@theyahia/travelpayouts-mcp

Install

Environment Variables

Claude Desktop Config

Tools (13)

Flights (8)

Hotels (2)

Lookup (3)

Auth

Demo Prompts

Development

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent