Passagens Api

Working · 786 ms

dev.passagens/passagens-apiv1.0.0 Domain verified

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

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://passagens.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

originstring, required

Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'GRU'). Nomes são resolvidos automaticamente. / IATA code or place name.

destinationstring, required

Código IATA ou nome do lugar em português (ex.: 'Tóquio', 'TYO'). Nomes são resolvidos automaticamente. / IATA code or place name.

currencystring

Moeda (3 letras), padrão BRL

depart_datestring

AAAA-MM ou AAAA-MM-DD

return_datestring

AAAA-MM ou AAAA-MM-DD

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

cheapest_route

Argument	Type	Description
origin*	string	Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'GRU'). Nomes são resolvidos automaticamente. / IATA code or place name.
currency	string	Moeda (3 letras), padrão BRL
depart_date	string	AAAA-MM ou AAAA-MM-DD
destination*	string	Código IATA ou nome do lugar em português (ex.: 'Tóquio', 'TYO'). Nomes são resolvidos automaticamente. / IATA code or place name.
return_date	string	AAAA-MM ou AAAA-MM-DD

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'GRU'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "currency": {
      "type": "string",
      "description": "Moeda (3 letras), padrão BRL"
    },
    "depart_date": {
      "type": "string",
      "description": "AAAA-MM ou AAAA-MM-DD"
    },
    "destination": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'Tóquio', 'TYO'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "return_date": {
      "type": "string",
      "description": "AAAA-MM ou AAAA-MM-DD"
    }
  }
}

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.

Argument	Type	Description
month	string	AAAA-MM, padrão mês atual
origin*	string	Código IATA ou nome do lugar em português (ex.: 'Rio de Janeiro', 'GIG'). Nomes são resolvidos automaticamente. / IATA code or place name.
currency	string	Moeda (3 letras), padrão BRL
destination*	string	Código IATA ou nome do lugar em português (ex.: 'Buenos Aires', 'EZE'). Nomes são resolvidos automaticamente. / IATA code or place name.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination"
  ],
  "properties": {
    "month": {
      "type": "string",
      "description": "AAAA-MM, padrão mês atual"
    },
    "origin": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'Rio de Janeiro', 'GIG'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "currency": {
      "type": "string",
      "description": "Moeda (3 letras), padrão BRL"
    },
    "destination": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'Buenos Aires', 'EZE'). Nomes são resolvidos automaticamente. / IATA code or place name."
    }
  }
}

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.

Argument	Type	Description
q*	string	Nome do lugar, ex.: 'Florianópolis', 'Porto', 'Nova York'
limit	integer	Máximo de resultados, padrão 5
locale	string	Idioma dos nomes retornados, padrão pt

Input schema (JSON)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Nome do lugar, ex.: 'Florianópolis', 'Porto', 'Nova York'"
    },
    "limit": {
      "type": "integer",
      "description": "Máximo de resultados, padrão 5"
    },
    "locale": {
      "type": "string",
      "description": "Idioma dos nomes retornados, padrão pt"
    }
  }
}

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.

Argument	Type	Description
dias	integer	Dias de histórico, 1–365, padrão 90
origin*	string	Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'SAO'). Nomes são resolvidos automaticamente. / IATA code or place name.
destination*	string	Código IATA ou nome do lugar em português (ex.: 'Lisboa', 'LIS'). Nomes são resolvidos automaticamente. / IATA code or place name.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination"
  ],
  "properties": {
    "dias": {
      "type": "integer",
      "description": "Dias de histórico, 1–365, padrão 90"
    },
    "origin": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'SAO'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "destination": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'Lisboa', 'LIS'). Nomes são resolvidos automaticamente. / IATA code or place name."
    }
  }
}

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.

Argument	Type	Description
limit	integer	Máximo de resultados 1–100, padrão 10
direct	boolean	Só voos diretos, padrão false
origin*	string	Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'GRU'). Nomes são resolvidos automaticamente. / IATA code or place name.
currency	string	Moeda (3 letras), padrão BRL
max_days	integer	Duração máxima da viagem em dias
min_days	integer	Duração mínima da viagem em dias (busca ida e volta com janela flexível)
depart_date	string	AAAA-MM (mês flexível) ou AAAA-MM-DD
destination*	string

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.

Argument	Type	Description
origin*	string	Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'SAO'). Nomes são resolvidos automaticamente. / IATA code or place name.
depart_date*	string	AAAA-MM-DD da ida
destination*	string	Código IATA ou nome do lugar em português (ex.: 'Lisboa', 'LIS'). Nomes são resolvidos automaticamente. / IATA code or place name.
return_date*	string	AAAA-MM-DD da volta

Input schema (JSON)

{
  "type": "object",
  "required": [
    "origin",
    "destination",
    "depart_date",
    "return_date"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'São Paulo', 'SAO'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "depart_date": {
      "type": "string",
      "description": "AAAA-MM-DD da ida"
    },
    "destination": {
      "type": "string",
      "description": "Código IATA ou nome do lugar em português (ex.: 'Lisboa', 'LIS'). Nomes são resolvidos automaticamente. / IATA code or place name."
    },
    "return_date": {
      "type": "string",
      "description": "AAAA-MM-DD da volta"
    }
  }
}