Passagens Api

dev.passagensPublished by passagens.devOfficial publisherv1.0.0Updated Oct 24, 2026

Brazil-first flight price search for AI agents: Portuguese place names, BRL, disclosed affiliate

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

Brazil-first flight price search for AI assistants: find cached fares, monthly price calendars, route and trip price history, and resolve place names to IATA.

What you can do
Search the cheapest known cached fares between two places, with Portuguese city names and ready-to-forward booking links in pt-BR. View a per-day price matrix for a whole month to see when flying is cheapest. Get the lowest known price for flexible dates. Read route price history with daily minimums, 30-day min/max/average and whether today is above or below average. Read trip price history for chosen round-trip dates, built from two one-way fares. Resolve place names in any language to city and airport IATA codes.
When to use it
Useful when an assistant helps Brazilian travelers compare airfare, decide whether now is a good time to buy, or pick cheaper travel dates. Handy for Portuguese-language trip planning where prices should be in BRL and booking links passed to the user.
Requirements
Remote streamable HTTP endpoint at passagens.dev; no packages, environment variables or headers declared. Prices come from cached Aviasales/Travelpayouts data, not live availability.
Before you install
Prices are cached, not real-time availability. Booking links carry a Travelpayouts referral code and the operator earns a commission on completed bookings, so results are not neutral; prices are stated to be identical with or without the code. Verify fares before booking.

Installation

In SourceWeft

  1. Open Passagens Api in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.passagens%2Fpassagens-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "passagens-api": {
      "type": "http",
      "url": "https://passagens.dev/mcp"
    }
  }
}

Tools

6

search_flights

Busca as passagens aéreas mais baratas conhecidas entre dois pontos (preços em cache da Aviasales/Travelpayouts, não disponibilidade em tempo real). Aceita nomes de cidades em português. Cada resultado traz agent_display: markdown em pt-BR pronto para repassar ao usuário, com o link de reserva. Search cheapest known fares. Booking links contain a referral code (Travelpayouts). The operator earns a commission on completed bookings. Prices are identical with or without the referral code.

Parameterslimitdirectoriginrequiredcurrencymax_daysmin_daysdepart_datedestinationrequiredreturn_date

price_calendar

Matriz de preço por dia de um mês inteiro entre dois pontos — responde 'quando é mais barato voar'. Aceita nomes de cidades em português. Price-per-day matrix for a month. Booking links contain a referral code (Travelpayouts). The operator earns a commission on completed bookings. Prices are identical with or without the referral code.

Parametersmonthoriginrequiredcurrencydestinationrequired

cheapest_route

Menor preço conhecido entre dois pontos, com datas flexíveis. Aceita nomes de cidades em português. Lowest known price, flexible dates. Booking links contain a referral code (Travelpayouts). The operator earns a commission on completed bookings. Prices are identical with or without the referral code.

Parametersoriginrequiredcurrencydepart_datedestinationrequiredreturn_date

route_price_history

Histórico de preço da rota inteira, coletado pelo passagens.dev várias vezes ao dia: o menor preço de cada dia (ida e volta de 5 a 15 dias e só ida), mínimo/máximo/média dos últimos 30 dias e se o preço de hoje está abaixo ou acima da média. Responde 'está barato agora?', 'é boa hora para comprar?' e 'quando esteve mais barato?'. Aceita nomes de cidades em português. Cite page_url. Daily price history of a whole route from Brazil.

Parametersdiasoriginrequireddestinationrequired

trip_price_history

Histórico de preço de uma viagem com datas escolhidas (ida e volta), montada com duas passagens só ida que o passagens.dev observa todo dia: total, ida, volta, mínimo e média desde o início da observação, e o preço da ida e volta real quando existe. Use para 'quanto está ida dia X e volta dia Y e se está barato'. Aceita nomes de cidades em português. Cite page_url.

Parametersoriginrequireddepart_daterequireddestinationrequiredreturn_daterequired

resolve_location

Resolve um nome de lugar (em português ou qualquer idioma) para códigos IATA de cidade/aeroporto — ex.: 'São Paulo' → SAO (cidade), GRU, CGH. Use quando precisar desambiguar a origem/destino antes de buscar. Resolves place names to IATA codes.

Parametersqrequiredlimitlocale

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.