Google Flights MCP Server

Un servidor alojado del Model Context Protocol (MCP) que ofrece a Claude, Cursor, Windsurf y cualquier otro cliente MCP una herramienta de Google Flights. Busca itinerarios de ida, de ida y vuelta y de varias ciudades con tarifas, tramos de vuelo, emisiones de carbono e historial de precios, todo como JSON estructurado, sin necesidad de cuenta de Google ni de lidiar con una API de viajes retirada.

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

Contenido

• Lo que necesitas

• Inicio rápido

• Ejemplos de prompts

• Herramientas

• Errores y rutas de fallo

• Precios, nivel gratuito y límites

• Selección de herramientas

• Cómo se compara

• Preguntas frecuentes

• Enlaces de HasData

• Desarrollo

• Contribuciones

• Licencia

Related MCP server: SkyOdyssey MCP

Lo que necesitas

Un cliente MCP y una clave de API de HasData desde el panel, que se crea gratis sin tarjeta, y la prueba cubre unas 66 llamadas a la tarifa de 15 créditos. Este es un servidor remoto, así que el camino más simple es una URL y una cabecera x-api-key, sin contenedor que ejecutar y sin cuenta de Google en ningún punto del flujo. Un cliente que solo hable stdio llega a él mediante un lanzador ligero, publicado como @hasdata/google-flights-mcp en npm y hasdata-google-flights-mcp en PyPI, como se muestra abajo.

Inicio rápido

La URL del servidor es la misma para todos los clientes. Lo probamos de primera mano en Claude Code y Claude Desktop. Los demás bloques siguen el formato documentado de cada cliente para un servidor remoto.

Los clientes con soporte OAuth pueden añadir la misma URL como conector e iniciar sesión sin poner una clave en un archivo de configuración.

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

Ajustes, luego Conectores, luego Añadir conector personalizado, luego pega https://mcp.hasdata.com/api/mcp?apis=google_travel_flights e inicia sesión.

Para la ruta del archivo de configuración, Claude Desktop solo carga servidores locales (stdio), así que llega a un servidor remoto a través de un lanzador stdio. El paquete @hasdata/google-flights-mcp es ese lanzador, y lee la clave del entorno. Añade esto a claude_desktop_config.json:

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

Para Python en lugar de Node, cambia el lanzador por el paquete de PyPI, que uvx ejecuta sin instalación manual:

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

~/.cursor/mcp.json para cada proyecto, o .cursor/mcp.json para uno solo:

{
  "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 llama al campo serverUrl, no 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 en el espacio de trabajo:

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

Ejemplos de prompts

Son prompts, no código. Pega uno y el agente elige la herramienta por sí mismo. Cada uno lleva anotadas las llamadas que requiere, porque cada llamada correcta cuesta 15 créditos.

Busca vuelos de ida de JFK a Londres Heathrow el 15 de septiembre, ordenados por precio, y dame los tres más baratos con aerolínea y estimación de carbono.

Una llamada, 15 créditos. Las tarifas, los tramos y las emisiones vienen todos juntos.

La misma ruta, pero solo sin escalas, en clase business, y dime qué opción tiene las menores emisiones.

Una llamada, 15 créditos. La cabina y las escalas son filtros de una sola petición.

¿Es $295 un buen precio para JFK a LHR ahora mismo, dado el historial de precios?

Una llamada, 15 créditos. La respuesta incluye priceInsights con un rango típico y un nivel de precio.

Ida y vuelta JFK a LHR, salida el 15 de septiembre y regreso el 22 de septiembre, la tarifa más barata.

Dos llamadas, 30 créditos. Google devuelve primero las opciones de ida; luego el tramo de regreso es una segunda llamada determinada por la opción que elijas.

Un viaje de ida y vuelta es, por diseño, dos llamadas. La primera devuelve itinerarios de ida, cada uno con un departureToken, y pasas ese token de vuelta para obtener los vuelos de regreso correspondientes. La búsqueda de ida y la comprobación de precio son una sola llamada cada una.

Herramientas

Una sola herramienta, de solo lectura. La muestra siguiente está recortada de una llamada real, y las tarifas cambian constantemente. Léela como un esquema. El nombre de la herramienta enlaza con su referencia de endpoint, que incluye la lista completa de parámetros.

La muestra es la carga útil, no la respuesta completa. Un resultado de tools/call contiene un bloque de texto, y ese texto es a su vez JSON con url, status, text y json, con los datos extraídos en json. Desde una respuesta JSON-RPC cruda, la ruta es result.content[0].text, parseado, y luego .json. Un cliente de chat lo desempaqueta por ti; el código que habla directamente con el endpoint no.

Obtener resultados de Google Flights

hasdata_google_travel_flights_getGoogleFlights

Itinerarios para una ruta y una fecha, con tarifas, tramos, emisiones e historial de precios.

La referencia también documenta includeConnections, excludeConnections, layoverDuration, outboundTimes, returnTimes, showHidden, lessEmissions y multiCityJson.

Los resultados se dividen en bestFlights y otherFlights. Cada itinerario incluye price, type, totalDuration en minutos, un array flights de tramos, un objeto carbonEmissions y un bookingToken. Cada tramo contiene departureAirport y arrivalAirport (cada uno con id, name y time local), duration, airline, flightNumber, airplane, legroom, travelClass, un array extensions y oftenDelayedByOver30Min en los tramos que Google señala. Un itinerario sin escalas tiene un tramo; una conexión tiene varios.

carbonEmissions está en gramos, no en kilogramos. thisFlight: 433000 son 433 kg. differencePercent lo compara con typicalForThisRoute, así que un número negativo es un vuelo más ecológico que la media.

{
  "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..."
}

priceInsights aparece junto a los itinerarios con lowestPrice, un typicalPriceRange, un priceLevel como typical y un priceHistory de puntos [timestamp, price]. airports replica los aeropuertos de salida y llegada resueltos, con ciudad y país.

Errores y rutas de fallo

Tu cliente casi nunca ve un código de error HTTP en una llamada a una herramienta. La capa MCP responde con 200 y coloca el fallo dentro del resultado, con isError establecido en true y el motivo como texto. El agente lee un mensaje donde podrías esperar una línea de estado.

Una clave errónea aparece como salida de la herramienta, no como una conexión fallida. tools/list acepta cualquier clave no vacía y devuelve la herramienta, de modo que el cliente completa su handshake y se muestra en verde. La primera llamada a la herramienta devuelve entonces isError: true y el texto HasData API error: 401 Unauthorized. Estate atento a esa cadena, porque nada anterior en el flujo informa del problema.

Una clave ausente es el único error HTTP real. La autorización se ejecuta antes que cualquier herramienta, y la propia conexión falla con 401. Las cabeceras CORS están presentes, y un cliente de navegador lee el estado en lugar de un fallo de red opaco.

Un argumento que rompe el esquema de la herramienta se rechaza antes de convertirse en un scraping. El servidor responde con isError: true y el texto MCP error -32602: Input validation error, nombrando el campo infractor. Aquí se detectan un roundTrip sin returnDate, o includeAirlines junto con excludeAirlines.

Una ruta sin vuelos en la fecha devuelve un resultado correcto con los arrays de itinerarios vacíos, no un error. requestMetadata.status sigue leyendo ok. Comprueba los vuelos antes de clasificarlos.

Un código de aeropuerto incorrecto devuelve 400 con requestMetadata.status establecido en error. Usa códigos IATA o kgmids, no nombres de ciudades.

Los resultados que contienen datos también incluyen un requestMetadata.id que conviene citar al contactar con el soporte.

Precios, nivel gratuito y límites

Cada llamada a Google Flights cuesta 15 créditos por llamada con éxito. El tamaño de la respuesta no cambia el precio, y la búsqueda profunda cuesta lo mismo que una estándar.

La prueba gratuita son 1,000 créditos durante 30 días sin tarjeta, lo que equivale a unas 66 búsquedas de vuelos. Después, una cuenta activa sigue recibiendo 100 créditos de recarga cada día siempre que su saldo baje de 100, de modo que un agente de bajo volumen funciona en el nivel gratuito indefinidamente.

Los planes de pago empiezan en $49 al mes por 200,000 créditos, lo que equivale a unas 13,000 búsquedas. El precio unitario baja con el volumen: desde $3.68 por 1,000 llamadas en el plan inicial hasta $1.49 en Business, $1.25 en Growth y $1.12 en los planes de alto volumen más grandes.

Tu plan también define la concurrencia. La prueba gratuita permite 1 solicitud a la vez; Startup 15, Business 30, Growth 50, y los planes de alto volumen van de 200 a 1,500. Gestiona el caso de desbordamiento de forma defensiva en cualquier proceso desatendido.

Una solicitud cuya respuesta no sea 200 no se factura. Un viaje de ida y vuelta son dos llamadas, así que tenlo en cuenta al hacer el presupuesto.

Selección de herramientas

El parámetro de consulta apis decide qué herramientas ve tu agente. Menos herramientas significa menos contexto dedicado a las definiciones de herramientas y menos probabilidades de que el modelo elija la incorrecta.

?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

El parámetro acepta nombres de proveedores como google_travel y nombres de API individuales como google_travel_flights. Los nombres mal escritos se ignoran. Si todos los nombres son incorrectos, la solicitud falla con 400 y el cuerpo indica tanto lo que no reconoció como todos los valores válidos. Si omites el parámetro, el mismo endpoint expone las 57 herramientas de HasData.

Cómo se compara

Google retiró su API de vuelos QPX Express en 2018 y nunca la sustituyó, por lo que no existe una API oficial de Google Flights. Las opciones restantes son hacer scraping de los resultados públicos u obtener una licencia de los datos brutos de tarifas GDS, algo pesado y caro. Este servidor lee los mismos resultados que muestra el sitio y los devuelve como JSON.

Lo que este servidor no hace. No reserva ni paga. Lee tarifas, tramos y los tokens que el propio Google utiliza para pasar a la reserva, y te devuelve el paso de la reserva.

Preguntas frecuentes

¿Existe una API oficial de Google Flights?

No. Google cerró QPX Express en 2018 y no ha lanzado un sustituto. Todas las opciones leen los mismos resultados públicos que sirve el sitio web. Esta, mantenida por HasData, los devuelve como JSON estructurado.

¿Qué es un servidor MCP de Google Flights?

Un servidor que expone Google Flights como una herramienta que un cliente de IA puede llamar. El cliente envía una llamada de herramienta a través del Model Context Protocol, el servidor obtiene los itinerarios y devuelve JSON estructurado, y el modelo trabaja con el resultado. Este expone una única herramienta y se ejecuta de forma remota.

¿Por qué un viaje de ida y vuelta son dos llamadas?

Google devuelve primero las opciones de ida, cada una con un departureToken. Tú eliges una y pasas su token de vuelta para obtener los vuelos de vuelta que se combinan con ella. Eso refleja cómo funciona el sitio, y es la razón por la que un viaje de ida y vuelta cuesta 30 créditos.

¿Las cifras de carbono están en kilogramos?

No, en gramos. thisFlight: 433000 significa 433 kg, y differencePercent lo compara con la media de la ruta.

¿Qué es la búsqueda profunda?

Un modo más lento que devuelve exactamente lo que Google Flights muestra en un navegador. Déjalo desactivado para ganar velocidad, y actívalo cuando necesites paridad con el sitio.

¿Puedo usarlo junto con otras APIs de HasData?

Sí. El parámetro apis acepta una lista, y ?apis=google_travel añade Google Hotels junto a los vuelos. Omite el parámetro y lo tienes todo.

Cumplimiento y datos personales

HasData solo accede a datos disponibles públicamente. Los términos de una plataforma pueden restringir el acceso automatizado, y tú eres responsable de tu propio cumplimiento.

Enlaces de HasData

Desarrollo

Este repositorio es configuración y documentación para un servidor remoto. No hay paso de compilación ni nada que contenerizar.

Las pruebas en test/ verifican el contrato de la herramienta, la parte que puede romperse sin que haya un commit aquí. Comprueban que ?apis=google_travel_flights devuelve exactamente una herramienta, que sigue declarando sus parámetros obligatorios, que el nombre no ha cambiado y que la clave en uso es realmente aceptada. Esa última comprobación llama a la herramienta de verdad y cuesta 15 créditos, que es el precio de una prueba canaria que puede fallar por el motivo correcto.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

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

La misma suite se ejecuta en CI en cada push y una vez a la semana de forma programada, porque la lista de herramientas upstream puede cambiar sin que nadie toque este repositorio. Un fallo significa que la lista de herramientas se ha movido, que la clave ha dejado de funcionar o que el endpoint no era accesible, y el mensaje de la aserción indica cuál de ellos.

Contribuciones

Las correcciones de la tabla de parámetros y de la muestra de respuesta son la contribución más útil, porque son las partes que más se desactualizan. Incluye la llamada que hiciste y la respuesta que obtuviste. Las pull requests desde forks ejecutan la suite sin clave, y las comprobaciones en vivo se omiten en lugar de ponerse en rojo.

Licencia

MIT. Consulta LICENSE.