Mu
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Flight price search via Aviasales/Travelpayouts: fares by route, cheapest days, flexible dates.
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 14/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 26/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Aviasales Flight Prices. Folge https://mcp.popnx.com/i/stufently-aviasales-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Aviasales Flight Prices (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Aviasales Flight Prices für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "aviasales": { "command": "uvx", "args": [ "aviasales-mcp" ], "env": { "AVIASALES_API_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei AVIASALES_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Aviasales Flight Prices wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
SettingsDeveloperEdit Config
{
"mcpServers": {
"aviasales": {
"command": "uvx",
"args": [
"aviasales-mcp"
],
"env": {
"AVIASALES_API_TOKEN": "your-value"
}
}
}
}Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Aviasales Flight Prices und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Aviasales Flight Prices nutzt, oder ein Werkzeug von Aviasales Flight Prices in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
AVIASALES_MARKET 2-stelliger Markt, dessen Preis-Cache gelesen wird; ohne Angabe wird ru verwendet AVIASALES_DEFAULT_CURRENCY Standardwährung für Preise AVIASALES_PARTNER_ID Travelpayouts-Partner-ID, die in Buchungslinks eingebettet wird Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Aviasales Flight Prices noch nicht verbinden
Aviasales Flight Prices läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Aviasales Flight Prices verbinden kann
B · Andere in Reisen, Karten & Wetter, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Aviasales Flight Prices (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Aviasales Flight Prices für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user aviasales --env AVIASALES_API_TOKEN=your-value -- uvx aviasales-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei AVIASALES_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Aviasales Flight Prices wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user aviasales --env AVIASALES_API_TOKEN=your-value -- uvx aviasales-mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Aviasales Flight Prices sollte in der Liste als verbunden erscheinen
Nutze Aviasales Flight Prices und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Aviasales Flight Prices nutzt, oder ein Werkzeug von Aviasales Flight Prices in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
AVIASALES_MARKET 2-stelliger Markt, dessen Preis-Cache gelesen wird; ohne Angabe wird ru verwendet AVIASALES_DEFAULT_CURRENCY Standardwährung für Preise AVIASALES_PARTNER_ID Travelpayouts-Partner-ID, die in Buchungslinks eingebettet wird Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Aviasales Flight Prices (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Aviasales Flight Prices für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "aviasales": { "command": "uvx", "args": [ "aviasales-mcp" ], "env": { "AVIASALES_API_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei AVIASALES_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Aviasales Flight Prices wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
In den Einstellungen von Aviasales Flight Prices ist AVIASALES_API_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Aviasales Flight Prices und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Aviasales Flight Prices nutzt, oder ein Werkzeug von Aviasales Flight Prices in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
AVIASALES_MARKET 2-stelliger Markt, dessen Preis-Cache gelesen wird; ohne Angabe wird ru verwendet AVIASALES_DEFAULT_CURRENCY Standardwährung für Preise AVIASALES_PARTNER_ID Travelpayouts-Partner-ID, die in Buchungslinks eingebettet wird Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Aviasales Flight Prices (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Aviasales Flight Prices für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "aviasales": { "type": "stdio", "command": "uvx", "args": [ "aviasales-mcp" ], "env": { "AVIASALES_API_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei AVIASALES_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Aviasales Flight Prices wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Aviasales Flight Prices ist AVIASALES_API_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Aviasales Flight Prices und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Aviasales Flight Prices nutzt, oder ein Werkzeug von Aviasales Flight Prices in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
AVIASALES_MARKET 2-stelliger Markt, dessen Preis-Cache gelesen wird; ohne Angabe wird ru verwendet AVIASALES_DEFAULT_CURRENCY Standardwährung für Preise AVIASALES_PARTNER_ID Travelpayouts-Partner-ID, die in Buchungslinks eingebettet wird Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Claude Code
claude mcp add --scope user aviasales --env AVIASALES_API_TOKEN=your-value -- uvx aviasales-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"aviasales": {
"command": "uvx",
"args": [
"aviasales-mcp"
],
"env": {
"AVIASALES_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"aviasales": {
"command": "uvx",
"args": [
"aviasales-mcp"
],
"env": {
"AVIASALES_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"aviasales": {
"type": "stdio",
"command": "uvx",
"args": [
"aviasales-mcp"
],
"env": {
"AVIASALES_API_TOKEN": "your-value"
}
}
}
}AVIASALES_API_TOKEN geheim erforderlich envAVIASALES_MARKET envAVIASALES_DEFAULT_CURRENCY envAVIASALES_PARTNER_ID envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
oci: ghcr.io/stufently/aviasales-mcp:0.5.3pypi: aviasales-mcpBasierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto stufently bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 10 Tagen
Nutzt GPL-3.0
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Keine Einträge auf OSV.dev für aviasales-mcp@0.5.3
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/stufently-aviasales-mcp)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: AVIASALES_API_TOKEN
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 10 Tagen geändert, und die neueste Version (0.5.3) kam vor 36 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker, Python (uv) auf deinem Computer.
In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Whimsical, HasData Google Maps
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.
Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.
Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.
Google Maps places, reviews, contributor history, photos and posts as JSON. No Google Cloud.
| Dieser Aviasales Flight Prices | Mu | Award Travel Finder | Killbottleneck | Whimsical | HasData Google Maps | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | In der Cloud oder auf deinem Rechner |
| Braucht Schlüssel | Ja | Nein | Nein | Ja | Nein | Ja |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Ja | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 3/3 | 4/4 | 5/5 |
| Lizenz | GPL-3.0 | AGPL-3.0 | MIT | MIT | MIT | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
MCP server for flight price search via Aviasales / Travelpayouts Data API. Fifteen read-only tools that let Claude Code, Claude Desktop, Cursor or any other MCP client answer flight-price questions: fares by route and month, the cheapest day to fly, flexible dates, budget and inspiration search, plus airport/city/airline lookup.
Unlike Google-Flights-scraping MCP servers, place names do not have to be guessed into IATA codes by the model: find_places, lookup_cities and find_nearest_airports resolve them.
Ask in plain language. The server picks the tool.
The same kind of question, with the tools a typical agent reaches for.
| Prompt | Tools it reaches for |
|---|---|
| "How much is a flight from Moscow to Istanbul in March?" | find_places → search_flights |
| "What's the cheapest day to fly to Bangkok in September?" | get_prices_calendar |
| "I'm flying Berlin→Lisbon on 12 May, back on the 19th — would shifting a day either way be cheaper?" | get_flexible_date_prices |
| "Where can I fly from St Petersburg for under 30 000 ₽?" | get_city_directions, search_by_price_range |
| "Which airport should I fly into for Pattaya, and what does it cost from Dubai?" | find_nearest_airports → search_flights |
| "Evening departures only, two adults and a child, business class." | search_flights with depart_after, adults, children, trip_class |
Paste this into a terminal. It is the same docker command every client block below runs; the process speaks MCP on stdin and waits there.
AVIASALES_API_TOKEN=your-token-here AVIASALES_MARKET=ru \
docker run -i --rm \ -e AVIASALES_API_TOKEN \ -e AVIASALES_MARKET \ ghcr.io/stufently/aviasales-mcp:latest
You need Docker, and a free Travelpayouts API token from https://www.travelpayouts.com/programs/100/tools/api. A wrong token still lets the process start (so does no token at all in the Docker image); it surfaces as an error on the first search. AVIASALES_MARKET is optional — see Configuration. Drop that variable and its -e pair if you do not need it.
:latest follows releases; pin a version tag (:0.5.3) if you would rather upgrade by hand.
Without Docker, the same server is on PyPI as aviasales-mcp (Python 3.12+). uvx fetches and runs it in one step:
AVIASALES_API_TOKEN=your-token-here AVIASALES_MARKET=ru uvx aviasales-mcp
pip install aviasales-mcp puts the same aviasales-mcp command on your PATH. In a client config, use "command": "uvx", "args": ["aviasales-mcp"] with the token in env instead of the docker command in the blocks below.
Every block runs the same docker command as the terminal snippet above. -e AVIASALES_API_TOKEN with no value hands the container the variable the client sets in env, so the token is written in exactly one place.
Keep the token out of anything you commit. A project-level
.mcp.json,
.cursor/mcp.jsonor.zed/settings.jsonis a normal thing to check into git,
and a token pasted there goes with it. Prefer the user-level config file, or
.gitignorethe project one.
Project file: .mcp.json in the project root.
{
"mcpServers": { "aviasales": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest" ], "env": { "AVIASALES_API_TOKEN": "your-token-here", "AVIASALES_MARKET": "ru" } } } }
Or from the terminal:
claude mcp add --scope user aviasales \
-e AVIASALES_API_TOKEN=your-token-here -e AVIASALES_MARKET=ru -- \ docker run -i --rm -e AVIASALES_API_TOKEN -e AVIASALES_MARKET \ ghcr.io/stufently/aviasales-mcp:latest
--scope user makes it available in every project and keeps the token in ~/.claude.json, out of the repository. Check with claude mcp list.
File: claude_desktop_config.json — macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json, Linux ~/.config/Claude/claude_desktop_config.json.
{
"mcpServers": { "aviasales": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest" ], "env": { "AVIASALES_API_TOKEN": "your-token-here", "AVIASALES_MARKET": "ru" } } } }
One click, without editing JSON: download the .mcpb from https://github.com/stufently/aviasales-mcp/releases/latest and open it. Claude Desktop installs the extension and asks for the Travelpayouts API token.
The same release includes checksums.txt, the SHA256 of every file attached to it: the .mcpb, and from the first PyPI release on also the sdist and the wheel, byte for byte the files uploaded to PyPI. Download it into the same directory as the bundle and check it before opening the bundle:
sha256sum -c --ignore-missing checksums.txt # run next to the downloaded files
On macOS, shasum -a 256 -c checks the same file.
Claude Desktop starts with a trimmed PATH and may not find docker by name: if the server fails to start, replace "docker" with its absolute path (which docker).
After installing, put your token in place of your-token-here in ~/.cursor/mcp.json. Or add the block below by hand.
File: ~/.cursor/mcp.json (every project) or .cursor/mcp.json (this project).
{
"mcpServers": { "aviasales": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest" ], "env": { "AVIASALES_API_TOKEN": "your-token-here", "AVIASALES_MARKET": "ru" } } } }
File: mcp_config.json — macOS and Linux ~/.config/devin/mcp_config.json (or $XDG_CONFIG_HOME/devin/mcp_config.json), Windows %APPDATA%\devin\mcp_config.json. Older builds read ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": { "aviasales": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest" ], "env": { "AVIASALES_API_TOKEN": "your-token-here", "AVIASALES_MARKET": "ru" } } } }
File: settings.json at ~/.config/zed/settings.json (or zed: open settings).
{
"context_servers": { "aviasales": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest" ], "env": { "AVIASALES_API_TOKEN": "your-token-here", "AVIASALES_MARKET": "ru" } } } }
codex mcp add aviasales --env AVIASALES_API_TOKEN=your-token-here -- \
docker run -i --rm -e AVIASALES_API_TOKEN ghcr.io/stufently/aviasales-mcp:latest
Or by hand in ~/.codex/config.toml:
[mcp_servers.aviasales]
command = "docker" args = ["run", "-i", "--rm", "-e", "AVIASALES_API_TOKEN", "-e", "AVIASALES_MARKET", "ghcr.io/stufently/aviasales-mcp:latest"]
[mcp_servers.aviasales.env] AVIASALES_API_TOKEN = "your-token-here" AVIASALES_MARKET = "ru"
Command docker, arguments run -i --rm -e AVIASALES_API_TOKEN ghcr.io/stufently/aviasales-mcp:latest, and AVIASALES_API_TOKEN in the environment the client gives the process. The server is also listed in the official MCP registry as io.github.stufently/aviasales-mcp, which clients with a registry browser can install from directly.
Only what was actually run is marked verified. Everything else is a config written from the client's documentation and has not been tried.
| Client or path | OS | Status | How |
|---|---|---|---|
| Test suite, Python 3.12 / 3.13 / 3.14 | Linux (GitHub ubuntu-latest) | Verified on every PR and push to main | ci.yml; HTTP is mocked |
| Docker runtime image build | Linux (GitHub ubuntu-latest) | Verified on every PR and push to main | ci.yml |
Plain MCP over stdio (initialize, tools/list) with the Docker image | Linux x86_64 | Verified 2026-10-12 | 13 tools listed, every one readOnlyHint: true, destructiveHint: false |
| Claude Code 2.1.296, Docker command from this README | Linux x86_64 | Verified 2026-10-12: connects and lists all 13 tools | A placeholder token; no tool call reached the API in this check |
uv run launch used by the .mcpb | Linux, ghcr.io/astral-sh/uv image | Verified 2026-10-10: starts and answers tools/list | Without Claude Desktop |
| Travelpayouts Data API with a real token | Linux | Verified 2026-07-29 (live probe of the Data API endpoints) | See CHANGELOG |
Claude Desktop (.mcpb or JSON config) | macOS, Windows, Linux | Not verified | No Claude Desktop on the test host |
| Cursor, Windsurf, Zed, Codex | any | Not verified | Configs follow each client's docs as of 2026-10-10 |
| Any client on macOS or Windows | macOS, Windows | Not verified | |
uvx aviasales-mcp@0.5.3 from PyPI over stdio (initialize, tools/list) | Linux, ghcr.io/astral-sh/uv image | Verified 2026-10-14: 13 tools listed | A placeholder token; no tool call reached the API |
All thirteen tools only read: they search cached fares and reference data. None books, buys, writes or changes anything, and none costs money to call beyond the Travelpayouts rate limit, so there is no separate read-only mode to turn on.
| Tool | Description |
|---|---|
search_flights | Prices between two cities on a date or across a month (v3/prices_for_dates) |
get_prices_calendar | Prices grouped by day or month — the cheapest day to fly |
get_flexible_date_prices | Prices for the days around your dates — "would shifting a day be cheaper?" |
get_latest_prices | Most recently found fares, optionally filtered by route |
get_special_offers | Airline promotions from a required origin, optionally filtered by destination or airline |
get_popular_directions | Where travellers reach a destination from |
get_city_directions | Cheapest destinations reachable from a city — inspiration search |
get_alternative_directions | Prices for nearby airports/cities |
search_by_price_range | Flights inside a budget; omit the destination to search anywhere (no date filter — the endpoint ignores one) |
search_flights, get_prices_calendar, get_flexible_date_prices, get_latest_prices and get_special_offers accept adults (1–9), children (0–8), `in