passagens-api
Brazil-first flight price search for AI agents: Portuguese place names, BRL, disclosed affiliate
Should I use this
Quality & Safety
Findings (3)
- LOWTool 'price_calendar' description lacks action verbin price_calendar
- LOWTool 'cheapest_route' description lacks action verbin cheapest_route
- LOWTool 'resolve_location' description lacks action verbin resolve_location
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"passagens-api": {
"url": "https://passagens.dev/mcp"
}
}
}Remote endpoints
https://passagens.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢search_flights(origin, destination, depart_date, return_date, min_days, ...)
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.
Input Schema
{
"type": "object",
"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."
},
"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."
},
"depart_date": {
"type": "string",
"description": "AAAA-MM (mês flexível) ou AAAA-MM-DD"
},
"return_date": {
"type": "string",
"description": "AAAA-MM ou AAAA-MM-DD; omita para só ida"
},
"min_days": {
"type": "integer",
"description": "Duração mínima da viagem em dias (busca ida e volta com janela flexível)"
},
"max_days": {
"type": "integer",
"description": "Duração máxima da viagem em dias"
},
"currency": {
"type": "string",
"description": "Moeda (3 letras), padrão BRL"
},
"direct": {
"type": "boolean",
"description": "Só voos diretos, padrão false"
},
"limit": {
"type": "integer",
"description": "Máximo de resultados 1–100, padrão 10"
}
},
"required": [
"origin",
"destination"
]
}⚪price_calendar(origin, destination, month, currency)
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.
Input Schema
{
"type": "object",
"properties": {
"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."
},
"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."
},
"month": {
"type": "string",
"description": "AAAA-MM, padrão mês atual"
},
"currency": {
"type": "string",
"description": "Moeda (3 letras), padrão BRL"
}
},
"required": [
"origin",
"destination"
]
}⚪cheapest_route(origin, destination, depart_date, return_date, currency)
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.
Input Schema
{
"type": "object",
"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."
},
"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."
},
"depart_date": {
"type": "string",
"description": "AAAA-MM ou AAAA-MM-DD"
},
"return_date": {
"type": "string",
"description": "AAAA-MM ou AAAA-MM-DD"
},
"currency": {
"type": "string",
"description": "Moeda (3 letras), padrão BRL"
}
},
"required": [
"origin",
"destination"
]
}⚪resolve_location(q, locale, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Nome do lugar, ex.: 'Florianópolis', 'Porto', 'Nova York'"
},
"locale": {
"type": "string",
"description": "Idioma dos nomes retornados, padrão pt"
},
"limit": {
"type": "integer",
"description": "Máximo de resultados, padrão 5"
}
},
"required": [
"q"
]
}Community
Evidence