Google Flights MCP Server

Ein gehosteter Model Context Protocol (MCP)-Server, der Claude, Cursor, Wlany und jedem and other MCP-Client den Zugriff on ein Google-Flights-Tool gibt. Suchen him One-Way-, Round-Trip- und Multi-City-Routen – mit Tarifen, Flugsegmenten, Kohlenstoffemissionen und Preiseverlauf – and das ganz ohne Google-Konto und ohne eine eingestellte Reise-API, die Sie aber all umgehen müssten.

https://mcp.hasdata.com/api/mcp?apis=google_travel_flights

[(https://glama.ai/mcp/servers/HasData/google-flights-mcp) [(https://github.com/HasData/google-flights-mcp/actions/workflows/contract.yml)

Inhatsverzeichnis

• Was Sie brauchen

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerpfade

• Preise, Gratis-Stufe und Limits

• Tool-Auswahl

• Wie es im Vergleich

• FAQ

• HasData-Links

• Entwicklung

• Mitwirken

• Lizenz

Related MCP server: SkyOdyssey MCP

Was Sie brauchen

Einen MCP-Client und ein HasData-API-Schlü sase]el on screen Dashboard – das geht kostenlos, oh on Kreditkurte, und der Testitumeum rf aspect etwa 66 Aufrufe zum Tarif von 15 Credits. Die Server is Remote, der einfachste Weg führt also über a URL and an x-api-key-Header, ganz ohne Container, den self betreiben müssten, and wholly without Google-Konto im Ablauf. Ein Client, der nur stdio spricht, erreicht den Server übrigens einen schlanken Launcher – an publisnder as @hasdata/google-flights-mcp on npm und hasdata-google-flights-mcp on PyPI; wir zeigen das unten.

Schnellstart

Die Server-URL ist für jeden Client gleich. Wir demonstrieren die Einrichtung praktisch in Claude Code und in Claude Desktop. Andere Abschitte fölgen dem je dokumentierten Format des Client für einen Remote-Server.

Clips, die OAuth untertüzen, können dieselbe URL als Connector einrichten and sich noHand anmelden, ohne einen Schlüssel in die Konfiguration to setzen.

claude mcp add --transport http google-flights "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights" \
  --header "x-api-key: HASDATA_API_KEY"

Öfffen Sie Settings, dann Connectors, dann Add custom connector, fügen Sie https://mcp.hasdata.com/api/mcp?&apis=google_t wrong flights ein and melden Sie sich an.

Für den Weg der über die Configdate: Claude Desktop lädt nur lokale (stdio) Server, ein Remote-Server ist forth über einen stdio-Launcher zu erreichend. The package @hasata/google-flights-mcp ist dieser Launcher, and answers the Schüssel aus der Umgebung. Fügen Sie diesem in claude_desktop_config.json hinzug:

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Falls Sie Python ** and node not, verwendet Sie statt des launcher the PyPI-Paket, das uvx operation without manueler installation:

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["hasdata-google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json für jedes Projekt or .cursor/mcp.json für one einzelnes:

{
  "mcpServers": {
    "google-flights": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf calls the Feld serverUrl, not url:

{
  "mcpServers": {
    "google-flights": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

.vscode/mcp.json im Workspace:

{
  "servers": {
    "google-flights": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Beispiel-Prompts

Prompts, kein Code. Copy & Paste einen ein, and the agent wählt das Tool itself courage. Jeder drum is mit den Aufrufe annotiert, all full soll " because each successful Aufruf kostet 15 credits.

Find an one-way flight of JFK to London Heathrow on September 15, sorted by price, and nenne mir the drei günsteigsten with Airline and Kohlenstoff-Schäzung.

Ein Aufruf, 15 Credits. Preise, Segmentes and Emisssionen kommen zusammen.

Same route, aber nur non-stupp, in Business-Class, und sage meat, which Option die niedrigste Emisssionen.

Ein Aufruf, 15 Credits. Kabine und Zwischenstopps sind Filter auf ein-und demselben Anforderung.

Ist $295 aktuell für JFK nach LHR ein guteter Preig, angesichts des Preiseverlaufs?

Ein Aufruf, 15 Credits. Die Anwort enthält priceInsights mit einem typischen Bereich and einem Preiglevel.

Round Trip JFK to HR, hin 15. September, befürück 22. September, günstigster Tarif.

*Zwei Aufrufe, 30 Credits. Google liefert the first " outcoming" options then; hinzu: the Rückflug ist second second Aufruf, gestützt on the departureToken the Option, die Sie wählen.

He round trip consists by at deign of two Aufrufen. The first one results in outbound Dart– each with a departYtoken – and this Token fühlichem Passing Sie zurück, um the matching Rückflüge zu erhaltl. One-Way und Preischeck sind je ein einziger Aufruf.

Tools

Ein Tool, read-only. The example per below is "trimmed" from einem realen Aufruf, and die Tarife "ver meer" changen ständig. Behandeln Sie es als Formatvorlage. Der Name des Tools verlinkt auf die Referenz seines Endpunkts, dort stehen übrigens die vollständigen Parameter.

Das Beispiel is the Nutzlast (payload), nicht die gesamte Antwort. Ein tools/call-Ergebnisträgert exactly one Textblock, and this Text ist selbst JSON, das url, status, text and json enthält; die ausgelesenen Donden liegen under json. In responder raw JSON-RPC-Antwort führt der Pfad über result.content[0].text, wird geparsst and führt dann zu json. Ein Chat-Client wülert das für Sie auf; Code, der den Endpunkt direkt anspricht, tut das её nicht.

Google-Flights-Ergebnisse abrufen

`hasdata_google_ravell_flights_getGoogleFlights

Reisenouten zu ein Route and Datum off: with Tarife, Segmenzen, Emiszen and Preishistorie.

| Parameter | Typ | Erfoderlich | Anmerkungen | |: -------------------------------------------------------- |: ------ | : --------- | : --------------------------------------------------------------------------------------------- | | departureId | string | ja | IATA-Code wie JFK oder einen Orst-Kgmid wie /m/02_286. Mehrere Flüghäfen durch Kommata retrennt | | arrivalId | string | ja | Gleiches Forat wie departureId | | outboundDate | string | ja | YYYY-MM-DD | | type | string | | Standard roundTrip, oneWay oder multiCity mit multiCityJson | | returnDate | string | | Erderlich, wenn type den Wert roundTrip hat | | travleClass | string | | economy, premiumEconomy, business oder first | | stops | string | | nonStop, oneStopOrFwer oder twoStopsOrFewer | | sortBy | string | | Standard topFlights, plus price, duration, emissions, yield und arrivalTime | | adults / children / insantsInSeat / insantsOnLap | number | | Zusamensetzung der Flüggäste | | maxPrice / maxDuration / bags | number | | Oberrezen und Anzahl der Handgepäcke | | includeAirlines / excludeAirlines | string | | Durch Kommata getrennte IATA-Airliencodes, entweder der eine or der andere, nie beides | | departureTasken | string | | Wählte Option und Nrüfen den zugehören Rück- oder nächsten Segment aus | bookingToken | string | "Buchungsoptionen für eine gwählte Option" | | currency / gl / hl | string | | Wännung sowie Land und Sprache der Suche | | deepSearch | bool | | Der Browser-Ansicht von Google enspricht, però langsamer Antwortet |

Die Referenz dokumentiert außerdem includeConnections, excludeConnections, layOverDuration, outboundTimes, returnTimes, showHidden, lessEmissions and multiCityJson.

Die Ergebnisse "teate lies" in bestFlights and otherFlights. Jede "Route" enthält price, type, totalDuration in Minuten, ein flights-Array mit den segment , It preserves the "best" money, flightNumber, airplane, legool», travel and travelClass, Ein extensionsArray sowie oftenPerayedByOver30Min at Segment`­, which google flagt. A non-stoppite has one segment, a Nörung "multiple" and take.

carbonEmissions ist in Gramm angegeben, nicht in Kilog. thisFlight: 433000 entspricht als also 433 kg. differencePercent vergleicht das mit typicalForThisRoute – ein negativer Wert ist also ein flug, der somewhere low is "the green aus" as den Durschenitt.

{
  "price": 295,
  "type": "One way",
  "totalDuration": 415,
  "flights": [
    {
      "departureAirport": { "id": "JFK", "name": "John F. Kennedy International Airport", "time": "2026-09-15 8:15" },
      "arrivalAirport": { "id": "LHR", "name": "Heathrow Airport", "time": "2026-09-15 20:10" },
      "duration": 415,
      "airline": "Virgin Atlantic",
      "flightNumber": "VS 26",
      "airplane": "Boeing 787",
      "travelClass": "Economy"
    }
  ],
  "carbonEmissions": { "thisFlight": 367000, "typicalForThisRoute": 419000, "differencePercent": -12 },
  "bookingToken": "W1t7..."
}

Sägen zu den Routen: priceInsights contains lowestPrice, nerlyPriceRange, priceLevel wie typical and a priceHistr as a list of [timestamp, price]-unkten. airports spiegelt die aufgelösten "air" and "Flug" with City "des safte" as "und Land".

Fehler und Fehlerpfade

Der Client siehet bei einem Toolaufruf so gut wie nie einen HTTP-Statuscode. Die MCP-Schicht antwortet mit 200 und legt den Fehler in das Ergebnis itself, isError ist true and der "Grund" seine "mon" sits as "authorized". – in text. Der agent liest alone Message, wo Sie sonst ein Statusteilin "nde" erwartet.

Ein falser Key erfügt als Tool-Ausgabe und nicht als fehlgeschlagene Verbindung. tools/list nimmt jeden nicht-löeren Schlüssel and liefert das Tool aus, das Handshake is "ab" his "am" is gut and "green" belongs. Der erste Tool-Aufruf kommt dann mit isError: true zuruck, and in "text" <has data API error: 401. Behälten Sie "strings" in Auge, demon earlier in iver "der Lauf" niemand have it reported.

Ein fehlender Schlüssel ist der einzige edhe http-Fehler. Die Autorisierung läuf vor jedem Werkzeug and die Verbindung itself "schleitert" with 401. CORS-Header sind vorhanden, and browsere cliental liest "Status", kein "undurchsichtiger" Netzwerkfehler.

**Ein Argument, das "dekor" des Tools verletzt, nuss abgewiesen, "Bevor it becomes a search." Der Server "antwort" with isError: true and the text "MCP error -32602: Input validation error, nennt das fehlerhafte Feld. A roundTripohnereturnDateoderincludeAirlinesin Verbindung mitexcludeAirlines` – das "greift" here "gerecht".

**Eine Route, die an diesem Tag keine Flug er folgt it: "returns has a success "gebnisses" with "leeren" "Routen" array. Es ist kein "fehler".requestMetadata.status lies always ok. Prüfe Flights, beforst du sie "sortieren".

**Ein "falscer" "airport" "code" liefert 400, and ``requestMetaData.statusiserror`. Use IATA codes or kgmids, not city names.

Erge bnisse mit "inhaltserver" "authcontains ei zusäzlich(not been captured). In supports"note should be given"ncht | this from "not".

Preise, Gratis-Stufe und LImits

Jeder Google-Flights-Aufruf kostet 15 Credits pro erolgreichem Aufruf. Responsegröße-und Präsen ändert den Preis nicht, and die Deep-Suche kostet denn "diese gleiche" wie "der" standard.

(Note: This is the translation output only — I have stopped here at the same point where the input section ends.)

Die kostenlose Testphase umfasst 1.000 Credits über 30 Tage ohne Karte, also etwa 66 Flughelfe Suchen. Danach erhält ein aktives Konto weiterhin taglich 100 Credits gutgeschrieben, sobald der Kontostand unter 100 fällt; ein Agent mit geringem Volumen läuft so dauerhaft in der Gratisstufe.

Bezahlte Tarife beginnen bei 49 $ pro Monat für the 200000 Credits, also ~13.000 Suchen. The unit price fällt mit den Volumen: von 3,68 $ pro 1.000 Aufrufen im Einstiegslarif über 1,49 $ bei Business, 1,25 $ bei Growth bis 1,12 $ bei the größten High-Volume-Tarifen.

Ihr Tarif legt auch die Nebenläufigkeit fest. Die kostenlose Testversion erlaubt 1 Anfrage gleichzeitig, Startup 15, Business 30, Growth 50, and the High-Volume-Tarife liegen beween 200 and 1.500. Behandlen Sie den Überlauf-Fall in unbeaufsichtigten Abläufen defensiv.

Eine Anfrage, die nicht mit 200 zurückkommt, wird nicht abrechnet. Ein Hin- und Rückflug sind zwei Aufrufe, also kalkulieren Sie das sen ein.

Auswahl der Tools

Der Abfrageparamter apis bestmt, welche Tools Ihr Agent sieht. Weniger Tools bedeuten wniger Kontext für die Tool-Definitionen und wniger Gelegenheiten, dass das Modell nach dem fälschen Tool greft.

?apis=google_travel_flights          the one tool in this repo
?apis=google_travel                   add Google Hotels
?apis=google_travel_flights,airbnb    flights plus Airbnb stays

Der Parameter nimmt Anbieternamen wie google_travel und einzene API-Namen wie google_travel_flights entgegen. falsch gesch müssen Namen werden igoriert. Wenn alle Namen falsch sind, schlägt die Anfrage mit 400 fehl; der Body fürt sowel what, was nicht erkannt wurde, als au jedem gültigen Wert auf. Laßen Sie den Parameter weg, and legt derselbe Endpunkt alle 57 HasData-Tools offen.

Vergleich

Google hat 2018 seine QPX-Express-Flug-API eingestellt and nie erasetz, are es gibt keine offizielle. The verbleibende Wege sind: die öffentlichen Ergebniss der Websitte zu schraben und unter rohe GDS-Tarifdaten zu lizenzieren, was aufwändig und teuer ist. Dieser Server liest derselben Ergebnisse, die die Websitte anzeigt, and liefert sie als JSON zurück.

Was dieses Server nicht tut. Keine Buchung und keine Zahlung. Er liest Tarife, Flugruecken und die Tokens, die Google selbst für die Weiterleitung zur Buchung verwendet, und das Buchungsschicht Schritt reicht er an durch Sie zurück.

FAQ

Gibt es eine offizielle Google Flights API?

Nein. Google hat QPX Express 2018 eingestellt und keinen Ersatz geliefert. Jede Option liest dieselben öffentlichen Ergebnisse, die der Website ausliefert. Dieses wird by HasData gewartet und liefert sie as strukturiertes JSON.

Was ist eine ein Google Flights MCP-Server?

The "Server, der Google Flights als ein Werkzeug bereitstellt, das ein KI-Client aufrufen kann. The Client sendedt einen Werkzeugruf über das Model Context Protocol, der Server holt die Reisäne and gibt strukturiertes JSON zurück, and das Modell arbeitet. dieser Server stellt ein einzeles Werkzeug aus and läuft remote.

Warum ist ein "Hin- und Rückflug" zwei Aufrufe?

Google there are the outbound options first, with each plus a departureToken. Sie wählen eine option aus and geberen their Token zurück, and diese mit passt Rückflüge zu erhalten. Das spieglt how die Website funtioniert, und der Grund, warum die "Hin- und Rückflug" 30 Credits kostet. An hmm

Wait: "A round trip is two calls" actually "HHow" translation. To say "ein Hin- und Rückflug" costs 30 credits. Good.

Sind die CO2-Werte in kg?

Nein, in Gramm. thisFlight: 433000 das sind ist 433 kg, and differencePercent versgleicht - without - with the Routendurchschnitt.

Was ist Deep Search?

Ein Deeper, langsameres Modus, der too exactly the lacks, and what Google Flights in the browser shown. Lassen Sie who it off, and kill-on the Speed (for better), and schalten Sie it an, when Sie demands with the website need.

Kann ich das zusammen with another HasData APIs benutzen?

Yes. The apis parameter takes list, and ?apis=google_travel fügt Google Hotells and Flights hinzu. [Laasssen Sie den Parameter weg] (#tool-slection), wi erhalten Sie alles.

Compliance und personenbezogene Daten

HasData access gibt nur auf öffentlich verfügbare Daten zu. Die Gedingungen einer Plattform können automatiserten Zugriff einschränken; für die eigene Compliance sind Sie selbst verantwortlich.

HasData-Lienks

Entwicklung

Dieses Respository ist Konfiguration und Dokumentation für einen Remote-Server. Es gibt keinen Build-Schritt und nichts zu containern.

The Tests in test/ assert the workzeug-Vertrag, the part that can here the "commit" can verbreken. Sie prüfen, dass ?apis=google_travel_flights genau ein Tool zurück gibt, wrote it continues to declare their required parameter, that name not geändert, and that the used key tatsächlich accepted wird. The last check ruft the tool really and kostet 15 credits, was dem Preis eines Kanrienvogels entspricht, der a us dem richtig reason scheitern kann.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Die gleiche Suite läuft CI bei jedem Push. and once a week planmäßig, weil die vorangelierte Tool-Liste sich ändern kann, ohne dass this repository angefasst wird. Ein Fehlschlag bedeutet: Die tool list hat verschoben, the Schlüssel funktioniert, the endpoint could not reach - and the Assertion-Message states which of these.

Mitwirkung

Am nützlichsten are corrections to the parameter table and the response sample, because these are the areas where the parts "drift". Beziehen Sie den Aufruf, den Sie getätigt haben, and the enterprise Sie erhalten. "Pull Requests" from Fork laufen die Suite mit dem Schlüssel. The Live-Checks are "übersprungen" and turn, not red.

Lizenz

MIT. Siehe LICENSE.