Google Flights MCP Server

Хостируемый сервер Model Context Protocol (MCP), который даёт Claude, Cursor, Windsurf и любому другому MCP-клиенту один инструмент Google Flights. Ищите перелёты в одну сторону, туда-обратно и по нескольким городам с тарифами, сегментами перелёта, выбросами углерода и историей цен — всё в виде структурированного JSON, без учётной записи Google и без выведенного из эксплуатации туристического API, который нужно обходить.

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

Содержание

• Что вам нужно

• Быстрый старт

• Примеры промптов

• Инструменты

• Ошибки и сценарии сбоев

• Цены, бесплатный тариф и лимиты

• Выбор инструмента

• Сравнение

• FAQ

• Ссылки HasData

• Разработка

• Вклад в проект

• Лицензия

Related MCP server: SkyOdyssey MCP

Что вам нужно

Нужны MCP-клиент и ключ HasData API из панели управления — создать бесплатно, без карты, а пробный период покрывает около 66 вызовов по тарифу 15 кредитов. Это удалённый сервер, поэтому проще всего использовать URL и заголовок x-api-key, без контейнера для запуска и без учётной записи Google на любом этапе. Клиент, который понимает только stdio, подключается через тонкий лаунчер, опубликованный как @hasdata/google-flights-mcp на npm и hasdata-google-flights-mcp на PyPI, как показано ниже.

Быстрый старт

URL сервера одинаков для всех клиентов. Мы проверили его вживую в Claude Code и Claude Desktop. Остальные блоки следуют собственному документированному формату каждого клиента для удалённого сервера.

Клиенты с поддержкой OAuth могут добавить тот же URL как коннектор и войти, не помещая ключ в конфигурационный файл.

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

Настройки, затем Коннекторы, затем Добавить пользовательский коннектор, затем вставьте https://mcp.hasdata.com/api/mcp?apis=google_travel_flights и войдите.

Для пути через конфигурационный файл: Claude Desktop загружает только локальные (stdio) серверы, поэтому он подключается к удалённому серверу через stdio-лаунчер. Пакет @hasdata/google-flights-mcp и есть этот лаунчер, и он читает ключ из окружения. Добавьте это в claude_desktop_config.json:

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

Для Python вместо Node замените лаунчер на PyPI-пакет, который uvx запускает без ручной установки:

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

~/.cursor/mcp.json — для всех проектов, или .cursor/mcp.json — для одного:

{
  "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 называет поле serverUrl, а не 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 в рабочей области:

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

Примеры промптов

Промпты, а не код. Вставьте один — и агент сам выберет инструмент. Каждый помечен количеством вызовов, потому что каждый успешный вызов стоит 15 кредитов.

Найдите перелёты в одну сторону из JFK в лондонский Хитроу на 15 сентября, отсортированные по цене, и покажите три самых дешёвых с авиакомпанией и оценкой выбросов углерода.

Один вызов, 15 кредитов. Тарифы, сегменты и выбросы возвращаются вместе.

Тот же маршрут, но только без пересадок, бизнес-класс, и скажите, у какого варианта самые низкие выбросы.

Один вызов, 15 кредитов. Класс и пересадки — это фильтры в одном запросе.

Хорошая ли это цена — $295 за JFK–LHR прямо сейчас, с учётом истории цен?

Один вызов, 15 кредитов. Ответ содержит priceInsights с типичным диапазоном и уровнем цены.

Перелёт туда-обратно JFK–LHR, туда 15 сентября, обратно 22 сентября, самый дешёвый тариф.

Два вызова, 30 кредитов. Google сначала возвращает исходящие варианты, затем обратный сегмент — это второй вызов, привязанный к выбранному вами варианту.

Перелёт туда-обратно — это два вызова по замыслу. Первый возвращает исходящие маршруты, каждый с departureToken, и вы передаёте этот токен обратно, чтобы получить соответствующие обратные рейсы. Перелёт в одну сторону и проверка цены — по одному вызову каждый.

Инструменты

Один инструмент, только для чтения. Пример ниже сокращён из реального вызова, а тарифы постоянно меняются. Воспринимайте его как форму. Название инструмента ведёт к справочнику конечной точки, где приведён полный список параметров.

Пример — это полезная нагрузка, а не весь ответ. Результат tools/call содержит один текстовый блок, и этот текст сам является JSON, содержащим url, status, text и json, при этом извлечённые данные находятся внутри json. В сыром JSON-RPC-ответе путь — result.content[0].text, затем после разбора — .json. Чат-клиент разворачивает это за вас, а код, обращающийся к конечной точке напрямую, — нет.

Получение результатов Google Flights

hasdata_google_travel_flights_getGoogleFlights

Маршруты для направления и даты, с тарифами, сегментами, выбросами и историей цен.

В справочнике также описаны includeConnections, excludeConnections, layoverDuration, outboundTimes, returnTimes, showHidden, lessEmissions и multiCityJson.

Результаты разделяются на bestFlights и otherFlights. Каждый маршрут содержит price, type, totalDuration в минутах, массив flights из сегментов, объект carbonEmissions и bookingToken. Каждый сегмент содержит departureAirport и arrivalAirport (каждый с id, name и локальным time), duration, airline, flightNumber, airplane, legroom, travelClass, массив extensions и oftenDelayedByOver30Min — для сегментов, которые Google помечает. У маршрута без пересадок один сегмент, у маршрута с пересадками — несколько.

carbonEmissions указан в граммах, а не в килограммах. thisFlight: 433000 — это 433 кг. differencePercent сравнивает его с typicalForThisRoute, поэтому отрицательное число означает, что рейс экологичнее среднего.

{
  "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 расположен рядом с маршрутами и содержит lowestPrice, typicalPriceRange, priceLevel (например, typical) и priceHistory из точек [timestamp, price]. airports возвращает определённые аэропорты вылета и прилёта с городом и страной.

Ошибки и сценарии сбоев

Ваш клиент почти никогда не видит HTTP-код ошибки от вызова инструмента. Уровень MCP отвечает 200 и помещает сбой внутрь результата, с isError равным true и причиной в виде текста. Агент читает сообщение там, где вы могли бы ожидать строку состояния.

Неправильный ключ проявляется как вывод инструмента, а не как неудачное подключение. tools/list принимает любой непустой ключ и возвращает инструмент, поэтому клиент завершает рукопожатие и показывает зелёный статус. Первый вызов инструмента возвращается с isError: true и текстом HasData API error: 401. Следите за этой строкой, потому что ничто раньше в процессе не сообщает о проблеме.

Отсутствующий ключ — единственная настоящая HTTP-ошибка. Авторизация выполняется раньше любого инструмента, и само подключение завершается с ошибкой 401. Заголовки CORS присутствуют, и браузерный клиент получает статус, а не непрозрачный сетевой сбой.

Аргумент, нарушающий схему инструмента, отклоняется до того, как будет выполнен скрейпинг. Сервер отвечает с isError: true и текстом MCP error -32602: Input validation error, называя поле, вызвавшее ошибку. roundTrip без returnDate или includeAirlines вместе с excludeAirlines отсеиваются здесь.

Направление без рейсов на дату возвращает успешный результат с пустыми массивами маршрутов, а не ошибку. requestMetadata.status по-прежнему содержит ok. Проверяйте рейсы, прежде чем ранжировать их.

Неверный код аэропорта возвращает 400 с requestMetadata.status в значении error. Используйте коды IATA или kgmids, а не названия городов.

Результаты с данными также содержат requestMetadata.id, который стоит указать в обращении в поддержку.

Цены, бесплатный тариф и лимиты

Каждый вызов Google Flights стоит 15 кредитов за успешный вызов. Размер ответа не меняет цену, а глубожий поиск стоит столько же, сколько обычный.

Бесплатная пробная версия — 1 000 кредитов на 30 дней без карты, это примерно 66 поисков авиабилетов. После этого активный аккаунт ежедневно получает пополнение на 100 кредитов, когда баланс опускается ниже 100, так что агент с невысоким объёмом запросов работает на бесплатном тарифе бессрочно.

Платные тарифы начинаются от $49 в месяц за 200 000 кредитов, это примерно 13 000 поисков. Цена за едницу снижается с объёмом: от $3,68 за 1 000 вызовов на начальном тарифе до $1,49 на Business, $1,25 на Growth и $1,12 на крупнейших тарифах с высоким объёмом.

Ваш тариф также определяет параллельность. Бесплатная пробная версия позволяет 1 запрос за раз, Startup — 15, Business — 30, Growth — 50, а тарифы с высоким объёмом — от 200 до 1 500. В любом автоматическом сценарии предусматривайте защитную обработку случая превышения лимита.

Запрос, вернувшийся с кодом не 200, не тарифицируется. Перелёт туда и обратно — это два вызова, так что закладывайте это в бюджет.

Выбор инструментов

Параметр запроса apis определяет, какие инструменты видит ваш агент. Меньше инструментов — меньше контекста тратится на определения инструментов и меньше шансов, что модель потянется не к тому из них.

?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

Параметр принимает имена провайдеров, например google_travel, и отдельные имена API, например google_travel_flights. Имена с опечатками игнорируются. Если все имена указаны неверно, запрос завершается с ошибкой 400, а в теле перечисляются и то, что не удалось распознать, и все допустимые значения. Если опустить параметр, тот же эндпоинт откроет доступ ко всем 57 инструментам HasData.

Сравнение

Google закрыл свой API авиаперелётов QPX Express в 2018 году и так и не заменил его, поэтому официального Google Flights API не существует. Остаются либо парсинг публичных результатов, либо лицензирование сырых данных о тарифах из GDS, что дорого и тяжеловесно. Этот сервер читает те же результаты, которые показывает сайт, и возвращает их в виде JSON.

Чего этот сервер не делает. Никакого бронирования и оплаты. Он читает тарифы, сегменты перелёта и токены, которые Google сам использует для перехода к бронированию, а шаг бронирования возвращает вам.

Частые вопросы

Существует ли официальный Google Flights API?

Нет. Google закрыл QPX Express в 2018 году и не выпустил замену. Любой вариант читает те же публичные результаты, которые отдаёт сайт. Этот вариант поддерживается HasData и возвращает их в виде структурированного JSON.

Что такое MCP-сервер Google Flights?

Это сервер, который предоставляет Google Flights как инструмент, вызываемый AI-клиентом. Клиент отправляет вызов инструмента по протоколу Model Context Protocol, сервер получает варианты перелётов и возвращает структурированный JSON, а модель работает с результатом. Этот сервер предоставляет один инструмент и работает удалённо.

Почему перелёт туда и обратно — это два вызова?

Google сначала возвращает варианты в одном направлении, каждый со своим departureToken. Вы выбираете один и передаёте его токен обратно, чтобы получить обратные рейсы, которые с ним сочетаются. Так работает сайт, и именно поэтому перелёт туда и обратно стоит 30 кредитов.

Значения углеродного следа в килограммах?

Нет, в граммах. thisFlight: 433000 означает 433 кг, а differencePercent сравнивает его со средним по направлению.

Что такое глубоий поиск?

Это более медленный режим, который возвращает ровно то, что Google Flights показывает в браузере. Оставьте его выключенным для скорости и включите, когда нужна идентичность с сайтом.

Можно ли использовать это вместе с другими API HasData?

Да. Параметр apis принимает список, а ?apis=google_travel добавляет Google Hotels к перелётам. Уберите параметр — и получите всё.

Соответствие требованиям и персональные данные

HasData получает доступ только к общедоступным данным. Условия платформы могут ограничивать автоматический доступ, и вы сами отвечаете за своё соответствие требованиям.

Ссылки HasData

Разработка

Этот репозиторий — конфигурация и документация для удалённого сервера. Этапа сборки нет, контейнеризовать нечего.

Тесты в test/ проверяют контракт инструмента — ту часть, которая может сломаться без коммита в этом репозитории. Они проверяют, что ?apis=google_travel_flights возвращает ровно один инструмент, что он по-прежнему объявляет свои обязательные параметры, что имя не изменилось и что используемый ключ действительно принимается. Последняя проверка реально вызывает инструмент и стоит 15 кредитов — это цена канарейки, которая может упасть по правильной причине.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

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

Тот же набор тестов запускается в CI при каждом пуше и раз в неделю по расписанию, потому что список инструментов выше по потоку может измениться, даже если никто не трогает этот репозиторий. Падение означает, что список инструментов сдвинулся, ключ перестал работать или эндпоинт недоступен, и сообщение проверки указывает, что именно.

Участие в разработке

Наиболее полезный вклад — исправления в таблице параметров и примере ответа, потому что именно эти части расходятся с реальностью. Прикладывайте сделанный вызов и полученный ответ. Pull request из форка запускает набор тестов без ключа, а живые проверки пропускаются, а не падают.

Лицензия

MIT. См. LICENSE.