easygroupflights MCP server
Commit 13. Okt. 2026Ermöglicht es KI-Assistenten, Gruppenangebote für Flugreisen ab 10 Personen anzufragen oder nach Live-Tarifen für kleinere Gruppen zu suchen.
Auch bekannt als codeblockssk/easygroupflights-mcp, easygroupflights-mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 Tage
- —
- Neueste Version
- 2.1.0
- Letzter Commit
- 13. Okt. 2026
- Lizenz
- MIT
Was ist easygroupflights MCP?
Ermöglicht es KI-Assistenten, Gruppenangebote für Flugreisen ab 10 Personen anzufragen oder nach Live-Tarifen für kleinere Gruppen zu suchen. Er stellt 5 Tools bereit, etwa egf_get_service_info, egf_prepare_group_quote, egf_request_group_quote.
Zusammenfassung generiert aus dem README des Projekts
Über easygroupflights MCP server
Die Organisation von Flugreisen für große Gruppen oder kleine Gruppen ist mit diesem MCP server möglich. Er unterstützt Reisende und Agenten, indem er zwischen Gruppenbuchungen ab 10 sitzenden Passagieren und kleineren Gruppen von 9 oder weniger Personen unterscheidet. Für große Gruppen ermöglicht der Server den Zugriff auf ausgehandelte Tarife von über 500 Fluggesellschaften, indem er strukturierte Anfragen vorbereitet, die zur manuellen Preisgestaltung an Spezialisten gesendet werden. Für kleinere Gruppen bietet er Zugriff auf live buchbare Tarife.
Nutzer verbinden sich via streamable HTTP über einen benutzerdefinierten Connector in Clients wie Claude Desktop oder Claude Code. Der Server nutzt einen zweistufigen Prozess für Gruppenanfragen, um die Genauigkeit zu gewährleisten; dies erfordert einen Vorbereitungsschritt, der ein Bestätigungstoken generiert, bevor die endgültige Anfrage gesendet wird. Entwickler können den Server mit spezifischen Secrets konfigurieren, wie etwa einem API key für das Intake-System oder einer URL, um zusätzliche Tarif-Services zu integrieren. Er bietet zudem spezialisierte Prompts für bestimmte Reisetypen wie Klassenfahrten, Hochzeiten oder Sportteams, um sicherzustellen, dass alle notwendigen Details erfasst werden.
Was du damit machen kannst
- 1Anfragen von Gruppenflug-AngebotenSende eine strukturierte Anfrage für 10 oder mehr Passagiere, um eine Antwort eines Spezialisten per E-Mail zu erhalten.
- 2Suche nach Tarifen für kleine GruppenFinde Live-Flugpreise und Fluggesellschaften für Gruppen von 9 oder weniger Reisenden.
- 3Planung spezialisierter GruppenreisenNutze geführte Prompts, um spezifische Details für Hochzeiten, Klassenfahrten oder Firmen-Offsites zu erfassen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du easygroupflights MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügeneasygroupflights MCP in Claude Code installieren
$ claude mcp add --transport http easygroupflights-mcp https://mcp.easygroupflights.com/mcpeasygroupflights MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"easygroupflights-mcp": {
"url": "https://mcp.easygroupflights.com/mcp"
}
}
}easygroupflights MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"easygroupflights-mcp": {
"type": "http",
"url": "https://mcp.easygroupflights.com/mcp"
}
}
}easygroupflights MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"easygroupflights-mcp","type":"http","url":"https://mcp.easygroupflights.com/mcp"}'easygroupflights MCP in Codex installieren
$ codex mcp add easygroupflights-mcp --url https://mcp.easygroupflights.com/mcpeasygroupflights MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.easygroupflights-mcp] url = "https://mcp.easygroupflights.com/mcp"
easygroupflights MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http easygroupflights-mcp https://mcp.easygroupflights.com/mcpeasygroupflights MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"easygroupflights-mcp": {
"url": "https://mcp.easygroupflights.com/mcp",
"type": "http"
}
}
}easygroupflights MCP tools 5
Erkannt aus dem READMEegf_get_service_infoegf_prepare_group_quoteegf_request_group_quoteegf_search_flightsegf_get_offer
| egf_get_service_info | — | |
| egf_prepare_group_quote | — | |
| egf_request_group_quote | — | |
| egf_search_flights | — | |
| egf_get_offer | — |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarcodeblockssk/easygroupflights-mcp is public and reachablegithub.com/codeblockssk/easygroupflights-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-13github.com/codeblockssk/easygroupflights-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 81 msBestanden
README
Auf GitHub anseheneasygroupflights MCP
A Model Context Protocol server for easygroupflights.com — IATA-accredited group air travel, with negotiated fares from 500+ airlines.
It lets an AI assistant do what the website does: work out whether a trip is a group booking, gather what an agent needs to price it, and put the enquiry in front of a human — or, for a party too small to be a group, find ordinary bookable fares.
Why a group needs a different tool
A group fare is negotiated directly with the airline. It is not sold through any public booking engine, so no search API can return a price for one. What this server does instead is submit a complete, structured enquiry and tell the traveller honestly what happens next: a specialist replies by email in about two hours, up to 24 for complex routings.
The dividing line is 10 seated travellers. Lap infants under two don't occupy a seat and don't count.
Tools
| Tool | What it does |
|---|---|
egf_get_service_info |
How group booking works, what the threshold is, what a quote costs and how long it takes. Submits nothing. |
egf_prepare_group_quote |
10+ travellers. Checks the brief and returns exactly what would be sent, with a confirmation token. Sends nothing. |
egf_request_group_quote |
Sends a prepared brief to a group specialist. Takes only the token. Returns a confirmation, not a price. |
egf_search_flights |
9 or fewer. Live fares with carriers and stops, each with an offer_id. |
egf_get_offer |
One fare by offer_id: price, flights, a booking link and valid_until. |
The two fare tools are withheld from tools/list unless PELIKAN_MCP_URL is set — an
advertised tool that cannot run is worse than one that isn't there.
egf_get_service_info ends with each market's human contacts — website, email,
phone and WhatsApp — so an agent can hand a user to a person.
Every tool:
- sets all four annotations (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint) explicitly. Onlyegf_request_group_quoteis a write, and nothing is destructive. - declares an
outputSchemaand returnsstructuredContentalongside the text. - takes snake_case inputs.
The write comes as a pair, because not every client asks the user before a write.
The prepare tool returns the summary and a confirmation_token, which is
signed with CONFIRM_SECRET and valid for 15 minutes. The write takes only
that token, so it cannot send anything the summary did not show.
It accepts an optional idempotency_key. Without one, the token
itself is the key, so a prepared write is carried out at most once. Keys are
kept for 24 hours, per Cloudflare data centre.
Callers presenting GATEWAY_TOKEN as a bearer token are the Tripdesk gateway:
- They get their own rate limit of 1,200 a minute; everyone else gets 60 a minute per address.
- Their booking links are left untagged. Direct callers' links get
utm_source=mcp.
Every tool call answers within 28 seconds.
egf_search_flights pages with limit (default 10, at most 20) and cursor.
Each fare carries one opaque offer_id, valid for 30 minutes. It is all
egf_get_offer needs. Search results carry no
booking links, and no session or trip ids.
Removed in 2.1
egf_prepare_flight_offer and egf_send_flight_offer (1.x send_flight_offer)
are gone. They passed through the fare service's agent-facing offer email,
which sent a branded email, with the caller's own text, to any address. The
directory review flagged that; egf_get_offer returns the booking link instead.
Upgrading from 1.x
2.0 renamed the tools with the egf_ prefix and the inputs to snake_case.
Most of what worked in 1.x still does:
- The old names (
request_group_quote, …) are still answered, though no longer listed. - camelCase arguments (
departureDate,fareId, …) are read as their snake_case names. - A 1.x one-step write is refused, with a message naming the prepare tool to call first.
Privacy
What the server receives, where it goes and how long it is kept: easygroupflights.com/mcp-privacy/. The controller is pelicantravel.com s.r.o.; privacy questions go to dpo@pelikan.sk.
Prompts
Guided briefs. In Claude Desktop and claude.ai they are under + → Connectors →
Add from Easygroupflights; in Claude Code they are /mcp__easygroupflights__<name>.
Each one walks the user through what the desk needs, plus the questions only that kind of trip raises,
and submits only once the user confirms.
| Prompt | For |
|---|---|
school-trip |
Schools and universities: pupils and staff separately, ages for supervision ratios, consent forms still coming in |
wedding-guests |
Destination weddings: guests from several cities, latest arrival, who pays |
sports-team |
Clubs and squads: first-match time, equipment, fixture risk |
company-offsite |
Offsites, incentives, conferences: the fixed week, cabin mix, one invoice |
pilgrimage |
Parishes and faith groups: how participants pay, accessibility |
Every prompt takes an optional market (en, pl, at) plus whatever is
already known: origin, destination, dates, travellers.
Resources
Material an agent can quote rather than recall, each served as markdown under its public URL — so a cited resource is already a link a reader can follow.
- Guides: every content page of the three market sites (16 each, in English,
Polish and German), read from the
/mcp-resources.jsoneach site publishes. - Studies: the published EGF Data Desk studies, in English and Polish, read from each blog's Ghost Content API. Tables stay tables.
Both are fetched on demand and cached for an hour, so new content reaches agents without redeploying the server.
Use it
claude mcp add --transport http easygroupflights https://mcp.easygroupflights.com/mcp
In Claude Desktop or claude.ai: Settings → Connectors → Add custom connector, and
paste https://mcp.easygroupflights.com/mcp.
Or in any other MCP client's config:
{
"mcpServers": {
"easygroupflights": {
"type": "http",
"url": "https://mcp.easygroupflights.com/mcp"
}
}
}
Transport is streamable HTTP. The server is stateless — it issues no session id and needs no Durable Objects, because every tool call is self-contained.
Configuration
Public values live in wrangler.toml:
| Variable | Meaning |
|---|---|
SITE_URL |
Human-facing site, shown in tool output and on the landing page |
GROUP_MIN_PASSENGERS |
Party size at which a booking becomes a group. Default 10 |
FARE_CURRENCY |
Currency the fare service quotes in. Default EUR |
Three secrets, set with wrangler secret put:
| Secret | Meaning |
|---|---|
AUTOPILOT_URL |
Group-enquiry intake. Infrastructure rather than a credential; a secret only because this repo is public |
AUTOPILOT_API_KEY |
Sent as X-API-Key to the intake. Without either of these egf_request_group_quote refuses rather than failing silently |
PELIKAN_MCP_URL |
Streamable-HTTP endpoint of the Pelikan MCP server, which prices sub-group parties. Optional — its tools stay hidden while unset |
Licence
MIT. See LICENSE.
Enquiries are attributed to the bare market domain. Autopilot only processes a source it recognises, so nothing may be appended to it.
Develop
npm install
npm run dev # wrangler dev on :8787
npm test # unit tests, no network
npm run typecheck
npm run deploy # wrangler deploy
Put local secrets in .dev.vars (gitignored). Leaving AUTOPILOT_API_KEY unset
is the safe way to exercise egf_request_group_quote end to end: it validates
everything and stops at the intake boundary without creating a real lead.
Drive it by hand with:
curl -s localhost:8787/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
GET / serves a human-readable page, /health a status probe, and
/.well-known/mcp.json a manifest for directories.
Markets
One site per market; the market decides both which brand handles the enquiry and which domain the lead is attributed to.
market |
Site | Language |
|---|---|---|
en |
easygroupflights.com | English |
pl |
grupoweloty.pl | Polish |
at |
gruppenfluege.at | German |
easygroupflights MCP Fragen
Wie füge ich easygroupflights MCP zu Claude Code hinzu?
Führe claude mcp add --transport http easygroupflights-mcp https://mcp.easygroupflights.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich easygroupflights MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet easygroupflights MCP?
Er stellt 5 Tools bereit, darunter egf_get_service_info, egf_prepare_group_quote, egf_request_group_quote, egf_search_flights, egf_get_offer.
Was ist die Mindestanzahl an Passagieren für eine Gruppenbuchung?
Eine Gruppenbuchung ist definiert als eine Gruppe von 10 oder mehr sitzenden Reisenden. Kleinkinder unter zwei Jahren werden bei dieser Grenze nicht mitgezählt.
Wie lange dauert es, bis man ein Gruppenflug-Angebot erhält?
Ein Spezialist antwortet in der Regel innerhalb von etwa zwei Stunden per E-Mail, wobei komplexe Routen bis zu 24 Stunden dauern können.
Kann ich sofort einen Preis für eine Gruppenbuchung erhalten?
Nein, Gruppentarife werden direkt mit den Fluggesellschaften ausgehandelt und sind nicht über öffentliche Buchungsmaschinen verfügbar. Der Server übermittelt stattdessen eine Anfrage, anstatt direkt einen Preis zurückzugeben.