Skip to content
MCP server

Aviasales Flight Prices

Flight price search via Aviasales/Travelpayouts: fares by route, cheapest days, flexible…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.3
Listing updated
5 days ago

About Aviasales Flight Prices

Aviasales Flight Prices is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Flight price search via Aviasales/Travelpayouts: fares by route, cheapest days, flexible dates.

Install

Run in a terminal

claude mcp add aviasales-mcp --env AVIASALES_API_TOKEN='<AVIASALES_API_TOKEN>' -- uvx aviasales-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aviasales-mcp": {
      "command": "uvx",
      "args": [
        "aviasales-mcp"
      ],
      "env": {
        "AVIASALES_API_TOKEN": "<AVIASALES_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aviasales-mcp": {
      "command": "uvx",
      "args": [
        "aviasales-mcp"
      ],
      "env": {
        "AVIASALES_API_TOKEN": "<AVIASALES_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "aviasales-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aviasales-mcp"
      ],
      "env": {
        "AVIASALES_API_TOKEN": "<AVIASALES_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aviasales-mcp": {
      "command": "uvx",
      "args": [
        "aviasales-mcp"
      ],
      "env": {
        "AVIASALES_API_TOKEN": "<AVIASALES_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aviasales-mcp": {
      "command": "uvx",
      "args": [
        "aviasales-mcp"
      ],
      "env": {
        "AVIASALES_API_TOKEN": "<AVIASALES_API_TOKEN>"
      }
    }
  }
}

Configuration

  • AVIASALES_API_TOKENTravelpayouts API token (https://www.travelpayouts.com/programs/100/tools/api)Required
  • AVIASALES_MARKET2-letter market whose price cache to read; unset falls back to ru
  • AVIASALES_DEFAULT_CURRENCYDefault price currency
  • AVIASALES_PARTNER_IDTravelpayouts partner ID embedded in booking links
  • AVIASALES_API_TOKENTravelpayouts API token (https://www.travelpayouts.com/programs/100/tools/api)Required
  • AVIASALES_MARKET2-letter market whose price cache to read; unset falls back to ru
  • AVIASALES_DEFAULT_CURRENCYDefault price currency
  • AVIASALES_PARTNER_IDTravelpayouts partner ID embedded in booking links

Pricing

Open source

Aviasales Flight Prices FAQ

Is Aviasales Flight Prices free?

Yes. Aviasales Flight Prices is open source, so you can use and self-host it for free.

How do I add Aviasales Flight Prices to Claude Code?

Run this command in your terminal: claude mcp add aviasales-mcp --env AVIASALES_API_TOKEN='<AVIASALES_API_TOKEN>' -- uvx aviasales-mcp