easygroupflights

com.easygroupflightsPublished by easygroupflights.comOfficial publisherv2.1.0Updated Oct 24, 2026

Group flight quotes for parties of 10 or more passengers.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Lets an assistant prepare and submit group flight enquiries for 10 or more travellers, or search live public fares for smaller parties.

What you can do
It explains how group air booking works for a given market and checks a group enquiry of 10 or more seated travellers, returning the exact brief that would go to a human specialist along with a short-lived confirmation token. A second tool sends that prepared brief, and a specialist replies by email with a written quote. For parties of 1 to 9 it searches live public fares with per-person prices, carriers and stops, and returns a single fare with a booking link by its offer_id.
When to use it
Useful when a user is organising travel for a large group and wants to hand a structured enquiry to a human agent, or when a smaller party just needs ordinary bookable fares. It is not a price source for group fares, since those are quoted by a person.
Requirements
A remote streamable HTTP endpoint; no local runtime or account is needed for the public tools. The fare search tools are only listed when the server operator has configured an upstream fare service endpoint.
Before you install
Submitting a group enquiry sends the traveller's trip details to a human specialist and creates a real lead, so confirm with the user first. The submit step takes only the token from the prepare step and returns a confirmation, not a price, and books or charges nothing. Fare offers expire after 30 minutes.

Installation

In SourceWeft

  1. Open easygroupflights in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.easygroupflights%2Feasygroupflights/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "easygroupflights": {
      "type": "http",
      "url": "https://mcp.easygroupflights.com/mcp"
    }
  }
}

README

easygroupflights 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

ToolWhat it does
egf_get_service_infoHow group booking works, what the threshold is, what a quote costs and how long it takes. Submits nothing.
egf_prepare_group_quote10+ travellers. Checks the brief and returns exactly what would be sent, with a confirmation token. Sends nothing.
egf_request_group_quoteSends a prepared brief to a group specialist. Takes only the token. Returns a confirmation, not a price.
egf_search_flights9 or fewer. Live fares with carriers and stops, each with an offer_id.
egf_get_offerOne 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. Only egf_request_group_quote is a write, and nothing is destructive.
  • declares an outputSchema and returns structuredContent alongside 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 [email protected].

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.

PromptFor
school-tripSchools and universities: pupils and staff separately, ages for supervision ratios, consent forms still coming in
wedding-guestsDestination weddings: guests from several cities, latest arrival, who pays
sports-teamClubs and squads: first-match time, equipment, fixture risk
company-offsiteOffsites, incentives, conferences: the fixed week, cabin mix, one invoice
pilgrimageParishes 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.json each 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

bash
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:

json
{  "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:

VariableMeaning
SITE_URLHuman-facing site, shown in tool output and on the landing page
GROUP_MIN_PASSENGERSParty size at which a booking becomes a group. Default 10
FARE_CURRENCYCurrency the fare service quotes in. Default EUR

Three secrets, set with wrangler secret put:

SecretMeaning
AUTOPILOT_URLGroup-enquiry intake. Infrastructure rather than a credential; a secret only because this repo is public
AUTOPILOT_API_KEYSent as X-API-Key to the intake. Without either of these egf_request_group_quote refuses rather than failing silently
PELIKAN_MCP_URLStreamable-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

bash
npm installnpm run dev        # wrangler dev on :8787npm test           # unit tests, no networknpm run typechecknpm 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:

bash
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.

marketSiteLanguage
eneasygroupflights.comEnglish
plgrupoweloty.plPolish
atgruppenfluege.atGerman

Source: README.md at commit d3f91c2

Tools

5

egf_get_service_info

About easygroupflights

Describes easygroupflights for one market: who it serves, how group fares differ from public tickets, what happens after a quote is requested, and how to reach a person. Submits nothing.

Parametersmarket

egf_prepare_group_quote

Prepare a group flight quote request

Checks a group flight enquiry for 10 or more seated travellers and returns the exact brief that would go to a human specialist, with a confirmation_token valid for 15 minutes. Nothing is sent.

Parametersnoteemailrequiredphonerequiredadultsrequiredmarketoriginrequiredyouthsinfantschildrenlast_namefirst_namecabin_class+8 more

egf_request_group_quote

Send a group flight quote request

Sends a prepared group flight enquiry to a human specialist, who replies by email with a written quote, usually within about 2 hours. Takes only the confirmation_token from preparing it; it returns a confirmation, not a price, and books or charges nothing.

Parametersidempotency_keyconfirmation_tokenrequired

egf_search_flights

Search flights for a small party

Searches live public fares for 1 to 9 travellers and returns options with per-person prices, carriers and stops, cheapest first, each with an offer_id valid for 30 minutes. Results come in pages: pass next_cursor back as cursor, with the same route and dates, for more.

Parameterslimitcursororiginrequiredpassengersdestinationrequiredreturn_datedeparture_daterequired

egf_get_offer

Get one flight offer

Returns one fare from a recent flight search, by its offer_id: the per-person price, the flights, a booking link and the time until which the offer_id is valid. Works for 30 minutes after the search.

Parametersoffer_idrequired

Version history

4
  1. v2.1.0LatestOct 13, 2026
  2. v2.0.0Oct 1, 2026
  3. v1.1.0Oct 1, 2026
  4. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Easygroupflights integrations