EasyGroupFlights MCP
MCP remoto para cotizaciones reales de tarifas aéreas grupales (10+ pasajeros) vía https://easygroupflights.com/ — especialistas IATA, no scraping de OTA. Endpoint https://mcp.easygroupflights.com/mcp
Documentación
easygroupflights MCP
Un servidor de Model Context Protocol para easygroupflights.com — viajes aéreos grupales acreditados por IATA, con tarifas negociadas de más de 500 aerolíneas.
Permite que un asistente de IA haga lo que hace el sitio web: determinar si un viaje es una reserva grupal, recopilar lo que un agente necesita para cotizarlo y poner la consulta frente a un humano — o, para un grupo demasiado pequeño para ser grupal, encontrar tarifas normales reservables.
Por qué un grupo necesita una herramienta diferente
Una tarifa grupal se negocia directamente con la aerolínea. No se vende a través de ningún motor de reservas público, por lo que ninguna API de búsqueda puede devolver un precio para una. Lo que este servidor hace en su lugar es enviar una consulta completa y estructurada y decirle al viajero con honestidad qué sucede después: un especialista responde por correo electrónico en unas dos horas, hasta 24 para rutas complejas.
La línea divisoria es 10 viajeros sentados. Los bebés de regazo menores de dos años no ocupan asiento y no cuentan.
Herramientas
| Herramienta | Qué hace |
|---|---|
get_service_info | Cómo funciona la reserva grupal, cuál es el umbral, cuánto cuesta una cotización y cuánto tarda. No envía nada. |
request_group_quote | 10+ viajeros. Envía una consulta estructurada a un especialista grupal. Devuelve una confirmación, no un precio. |
search_flights | 9 o menos. Tarifas reservables en vivo con aerolíneas, escalas y un enlace de reserva. |
send_flight_offer | Envía por correo electrónico una de esas tarifas al viajero como oferta formal. |
Las dos últimas se ocultan de tools/list a menos que PELIKAN_MCP_URL esté configurado — una
herramienta anunciada que no puede ejecutarse es peor que una que no está allí.
Úsalo
claude mcp add --transport http easygroupflights https://mcp.easygroupflights.com/mcp
O en la configuración de cualquier cliente MCP:
{
"mcpServers": {
"easygroupflights": {
"type": "http",
"url": "https://mcp.easygroupflights.com/mcp"
}
}
}
El transporte es HTTP de flujo continuo. El servidor no tiene estado — no emite ningún id de sesión y no necesita Durable Objects, porque cada llamada de herramienta es autocontenida.
Configuración
Los valores públicos viven en wrangler.toml:
| Variable | Significado |
|---|---|
SITE_URL | Sitio orientado a humanos, mostrado en la salida de la herramienta y en la página de inicio |
GROUP_MIN_PASSENGERS | Tamaño del grupo en el que una reserva se convierte en grupal. Predeterminado 10 |
FARE_CURRENCY | Moneda en la que el servicio de tarifas cotiza. Predeterminado EUR |
Tres secretos, configurados con wrangler secret put:
| Secreto | Significado |
|---|---|
AUTOPILOT_URL | Recepción de consultas grupales. Infraestructura más que una credencial; un secreto solo porque este repositorio es público |
AUTOPILOT_API_KEY | Enviado como X-API-Key a la recepción. Sin cualquiera de estos, request_group_quote se niega en lugar de fallar silenciosamente |
PELIKAN_MCP_URL | Endpoint HTTP de flujo continuo del servidor MCP de Pelikan, que cotiza grupos más pequeños. Opcional — sus herramientas permanecen ocultas mientras no esté configurado |
Licencia
MIT. Ver LICENSE.
Las consultas se atribuyen al dominio de mercado desnudo. Autopilot solo procesa una fuente que reconoce, por lo que no se le puede agregar nada.
Desarrollo
npm install
npm run dev # wrangler dev on :8787
npm test # unit tests, no network
npm run typecheck
npm run deploy # wrangler deploy
Coloca los secretos locales en .dev.vars (ignorado por git). Dejar AUTOPILOT_API_KEY sin configurar
es la forma segura de ejercitar request_group_quote de extremo a extremo: valida
todo y se detiene en el límite de la recepción sin crear un lead real.
Ejecútalo manualmente con:
curl -s localhost:8787/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
GET / sirve una página legible por humanos, /health una sonda de estado, y
/.well-known/mcp.json un manifiesto para directorios.
Mercados
Un sitio por mercado; el mercado decide tanto qué marca maneja la consulta como a qué dominio se atribuye el lead.
market | Sitio | Idioma |
|---|---|---|
en | easygroupflights.com | Inglés |
pl | grupoweloty.pl | Polaco |
at | gruppenfluege.at | Alemán |