Fli (Google Flights MCP) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Usa as próprias APIs protobuf do Google Flights — rápido e estável, sem scraping de HTML
Suporte a viagens de ida e volta, somente ida e multi-cidades
Busca por grade de datas: 'dia mais barato em maio de SFO para Tóquio'
Filtros por companhia aérea, aliança, escalas, cabine e preço máximo
Sem API key, sem cadastro — funciona direto da caixa
Disponível como biblioteca Python, CLI ou servidor MCP

Demo ao vivo

Como fica na prática

flights-fli-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "flights-fli-mcp": {
      "command": "uvx",
      "args": [
        "fli-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "flights-fli-mcp": {
      "command": "uvx",
      "args": [
        "fli-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "flights-fli-mcp": {
      "command": "uvx",
      "args": [
        "fli-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "flights-fli-mcp": {
      "command": "uvx",
      "args": [
        "fli-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "flights-fli-mcp",
      "command": "uvx",
      "args": [
        "fli-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "flights-fli-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "fli-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add flights-fli-mcp -- uvx fli-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Fli (Google Flights MCP)

Como encontrar o dia mais barato para voar entre duas cidades com o Claude

👤 Viajantes com datas flexíveis ⏱ ~10 min beginner

Quando usar: Você sabe para onde e aproximadamente quando, mas prefere mudar a data a pagar R$ 400 a mais.

Pré-requisitos

fli-mcp instalado — uvx fli-mcp (instalação automática via PyPI)

Fluxo

Solicitar grade de preços

Use o Fli. Mostre-me o dia mais barato para voar SFO → NRT na segunda metade de junho, ida e volta, estadia de 7 dias.✓ Copiado

→ Tabela de grade de datas com os menores preços de ida e volta por dia
Detalhar o par de datas mais barato

Para o par de datas mais barato, liste os itinerários reais — companhias aéreas, conexões, tempo total.✓ Copiado

→ 5 a 10 itinerários ordenados por preço, com companhia aérea e duração
Refinar a busca

Filtre para apenas voos diretos ou com no máximo 1 escala, com partida depois das 9h de SFO.✓ Copiado

→ Lista filtrada, bem mais curta

Resultado: Uma lista curta de voos com preços reais que você pode reservar diretamente no site da companhia aérea ou no Google Flights.

Armadilhas

Preços no site de reserva diferem do que você viu — Os preços do Google Flights são cache upstream; para taxas de OTA, acesse diretamente a companhia aérea. O Fli reflete o Google Flights, não a OTA.

Planeje uma viagem de negócios multi-cidades com o Claude fazendo as buscas

👤 Viajantes de negócios frequentes, assistentes executivos ⏱ ~20 min intermediate

Quando usar: Você tem 3 ou mais cidades para visitar e fazer a busca manualmente para cada trecho é cansativo.

Fluxo

Definir a rota

Planeje multi-cidades: SFO → JFK 12 de maio, JFK → LHR 15 de maio, LHR → SFO 20 de maio. Um adulto, classe executiva, máximo 1 escala por trecho.✓ Copiado

→ Itinerário multi-cidades com trechos e preços
Comparar alianças

Refaça a busca apenas com a Star Alliance para eu continuar acumulando milhas UA.✓ Copiado

→ Conjunto filtrado, possivelmente com preço mais alto — o Claude destaca a diferença
Exportar

Salve o itinerário escolhido em um resumo markdown com URLs de reserva e políticas de assento.✓ Copiado

→ Resumo gravado em disco; URLs funcionam

Resultado: Um plano multi-cidades pronto para reserva em menos de 10 minutos, em vez de 45 minutos de troca de abas.

Armadilhas

Algumas companhias aéreas não estão no Google Flights (Southwest) — O Fli herda a cobertura do Google Flights. A Southwest deve ser consultada separadamente.

Combine com: filesystem

Crie uma watchlist de promoções de voos que o Claude atualiza sob demanda

👤 Entusiastas e nômades digitais ⏱ ~25 min intermediate

Quando usar: Você quer monitorar 5 a 10 rotas e ser avisado quando um preço cair.

Fluxo

Definir a watchlist

Monitore estas 5 rotas pelos próximos 60 dias e armazene cada busca como JSON em /flights/watch.json.✓ Copiado

→ watch.json criado com 5 rotas
Executar a varredura

Busque os menores preços atuais para cada rota em watch.json. Compare com a última execução e destaque quedas acima de 15%.✓ Copiado

→ Tabela de diferenças; quedas em negrito

Resultado: Um alerta de queda de preço pessoal e leve, sem pagar pelo Hopper ou Going.

Armadilhas

Consultar o Google Flights muito rapidamente causa bloqueios temporários — Espaçe a varredura — 1 consulta a cada ~3 segundos é suficiente. Execute via cron, não em um loop fechado.

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

flights-fli-mcp + filesystem

Persistir uma watchlist de voos e histórico de preços em /flights/

Execute a watchlist de hoje. Salve os resultados em /flights/$(date +%Y%m%d).json e adicione ao history.csv.✓ Copiado

flights-fli-mcp + google-calendar

Após escolher um itinerário, adicionar os trechos ao calendário

Adicione os voos de ida e volta escolhidos como eventos no Calendar com os códigos de aeroporto no título.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_flights	origin: str, destination: str, depart_date, return_date?, passengers, cabin	Busca padrão de ida simples ou ida e volta	1 consulta ao Google Flights
search_date_grid	origin, destination, month, trip_length	Quando as datas são flexíveis e você quer descobrir o dia mais barato	1 consulta (mais pesada)
search_multi_city	legs[]: {origin, destination, date}	Itinerários com 3 ou mais cidades	1 consulta
filter	itineraries, filters: {airlines?, alliance?, max_stops?, time_window?, max_price?}	Refinar um conjunto de resultados sem nova consulta	gratuito (pós-busca)

Custo e limites

O que custa rodar

Cota de API: Sem cota formal — o Google Flights aplica limites suaves por IP (~1 consulta a cada poucos segundos)
Tokens por chamada: 300 a 2500 tokens por conjunto de resultados
Monetário: Gratuito
Dica: Use o search_date_grid com moderação — ele é mais pesado do que consultas pontuais.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum — sem API keys

Saída de dados: Todas as requisições vão para flights.google.com

O Google pode alterar o esquema protobuf a qualquer momento. A biblioteca é atualizada quando isso acontece, mas sem SLA.

Solução de problemas

Erros comuns e correções

HTTP 429 / bloqueio temporário

Você consultou rápido demais. Aguarde 5 a 10 minutos e reduza a cadência da varredura.

Verificar: Reexecute uma única consulta após a espera

Resultado vazio para uma rota válida

A data pode estar a mais de 11 meses no futuro (máximo do Google). Escolha uma data dentro dessa janela.

Companhia aérea ausente (Southwest etc.)

O Google Flights não indexa a Southwest. Use o site da companhia aérea diretamente para essas.

Alternativas

Fli (Google Flights MCP) vs. outros

Alternativa	Quando usar	Troca
SkyScanner / Amadeus / Duffel APIs	Você está construindo um produto real e precisa de reservas em conformidade com os termos de uso	Esses exigem keys e pagamento. O Fli é melhor para automação pessoal, não para um app público.
Kiwi.com Tequila API	Você precisa de cobertura de agregadores explícita, incluindo companhias de baixo custo	Tier gratuito limitado; o Fli tem cota zero mas com a cobertura do Google Flights.

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills