EasyGroupFlights MCP

easygroupflights MCP

Um servidor Model Context Protocol para easygroupflights.com — viagens aéreas em grupo credenciadas pela IATA, com tarifas negociadas de mais de 500 companhias aéreas.

Ele permite que um assistente de IA faça o que o site faz: descobrir se uma viagem é uma reserva de grupo, reunir o que um agente precisa para precificá-la e colocar a consulta diante de um humano — ou, para um grupo pequeno demais para ser considerado grupo, encontrar tarifas comuns reserváveis.

Por que um grupo precisa de uma ferramenta diferente

Uma tarifa de grupo é negociada diretamente com a companhia aérea. Ela não é vendida por nenhum mecanismo público de reservas, então nenhuma API de busca pode retornar um preço para ela. O que este servidor faz, em vez disso, é enviar uma consulta completa e estruturada e informar honestamente ao viajante o que acontece em seguida: um especialista responde por e-mail em cerca de duas horas, até 24 para roteiros complexos.

A linha divisória é 10 viajantes sentados. Bebês de colo com menos de dois anos não ocupam assento e não contam.

Ferramentas

Ferramenta	O que faz
get_service_info	Como funciona a reserva de grupo, qual é o limite, quanto custa uma cotação e quanto tempo leva. Não envia nada.
request_group_quote	10+ viajantes. Envia uma consulta estruturada a um especialista em grupos. Retorna uma confirmação, não um preço.
search_flights	9 ou menos. Tarifas reserváveis ao vivo com companhias, escalas e um link de reserva.
send_flight_offer	Envia uma dessas tarifas por e-mail ao viajante como uma oferta formal.

As duas últimas são ocultadas de tools/list a menos que PELIKAN_MCP_URL esteja definido — uma ferramenta anunciada que não pode ser executada é pior do que uma que não existe.

Como usar

claude mcp add --transport http easygroupflights https://mcp.easygroupflights.com/mcp

Ou na configuração de qualquer cliente MCP:

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

O transporte é HTTP streamable. O servidor não tem estado — ele não emite ID de sessão e não precisa de Durable Objects, porque cada chamada de ferramenta é autocontida.

Configuração

Valores públicos ficam em wrangler.toml:

Variável	Significado
SITE_URL	Site voltado para humanos, exibido na saída das ferramentas e na página inicial
GROUP_MIN_PASSENGERS	Tamanho do grupo a partir do qual uma reserva se torna grupo. Padrão: 10
FARE_CURRENCY	Moeda usada pelo serviço de tarifas. Padrão: EUR

Três segredos, definidos com wrangler secret put:

Segredo	Significado
AUTOPILOT_URL	Recebimento de consultas de grupo. Infraestrutura, não uma credencial; é segredo apenas porque este repositório é público
AUTOPILOT_API_KEY	Enviado como X-API-Key ao recebimento. Sem qualquer um deles, request_group_quote recusa em vez de falhar silenciosamente
PELIKAN_MCP_URL	Endpoint streamable-HTTP do servidor MCP Pelikan, que precifica grupos menores. Opcional — suas ferramentas permanecem ocultas enquanto não estiver definido

Licença

MIT. Veja LICENSE.

As consultas são atribuídas ao domínio de mercado puro. O Autopilot só processa uma fonte que reconhece, então nada pode ser anexado a ele.

Desenvolvimento

npm install
npm run dev        # wrangler dev on :8787
npm test           # unit tests, no network
npm run typecheck
npm run deploy     # wrangler deploy

Coloque segredos locais em .dev.vars (ignorado pelo git). Deixar AUTOPILOT_API_KEY sem definir é a maneira segura de exercitar request_group_quote de ponta a ponta: ele valida tudo e para na fronteira do recebimento sem criar um lead real.

Execute manualmente com:

curl -s localhost:8787/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

GET / serve uma página legível por humanos, /health uma sonda de status e /.well-known/mcp.json um manifesto para diretórios.

Mercados

Um site por mercado; o mercado decide tanto qual marca lida com a consulta quanto a qual domínio o lead é atribuído.

market	Site	Idioma
en	easygroupflights.com	Inglês
pl	grupoweloty.pl	Polonês
at	gruppenfluege.at	Alemão