Pesquise, cote e reserve hoteis de Cancun/Riviera Maya direto de uma IA (Cancun4me).
Scored across 13 tools
Most tools map to a single distinct action (cancel, pay, voucher, membership, coupon, club join, order status). The only soft overlap is the discovery funnel list_hotels → search_hotels → ver_quartos → get_hotel_info → get_quote, but the descriptions explicitly establish the ordering and required handles (search_id, hotel_slug, opcao_id), which keeps misselection unlikely.
All names are snake_case verb_noun (cancel_booking, create_payment, get_order_status, list_my_bookings, etc.), which is highly predictable. The single deviation is ver_quartos, the only Portuguese name in an otherwise English set, which breaks the language consistency an agent might pattern-match on.
13 tools sit comfortably in the well-scoped range for a hotel booking server. Each tool covers a discrete step (discovery, quoting, payment, tracking, voucher, cancellation, loyalty) with no redundant entries.
The core lifecycle is fully covered end to end: browse → live search → room selection → quote → payment → order status → voucher → cancel/list bookings, plus loyalty and coupon flows. Gaps remain around modifying an existing booking (date/guest changes), self-service penalty cancellation and refund tracking, which are pushed to a manual support email.
Cancela uma reserva. Se ainda estiver dentro do prazo gratis de uma tarifa
reembolsavel, cancela e estorna automaticamente. Se estiver fora do prazo (ou for
tarifa nao reembolsavel), a resposta vem com bloqueado: true — nesse caso avise o
hospede que o cancelamento com multa precisa ser tratado manualmente (support@cancun4.me),
NAO insista tentando de novo.
Inputs: token (required), order_id (required).
Cria o pedido e devolve o LINK DE PAGAMENTO (Stripe Checkout). O hospede tem que
abrir esse payment_url e pagar com o cartao na pagina do Stripe — NUNCA peca ou
digite dados de cartao aqui na conversa. A reserva na EZCONNECT so e efetivada
depois que o pagamento e confirmado (acompanhe com get_order_status).
hospedes: uma entrada {firstName, lastName} para CADA hospede (adultos + criancas —
o total tem que bater com adults+len(children_ages) da busca original).
voucher_code: cupom opcional (ex.: o cupom de boas-vindas de get_welcome_coupon).
Inputs: token (required), hospedes (required), opcao_id (required), search_id (required), +2 more.
Detalhe de UM hotel do catalogo pelo slug (retornado por list_hotels ou search_hotels). language: 'en', 'pt' ou 'es'.
Inputs: slug (required), language.
Status do Clube Cancun4me do hospede: se e membro ativo (creditos de 20% da primeira reserva e 10% das seguintes, para a proxima reserva, + acesso ao assistente de roteiro), quando expira, e quantas mensagens de IA de roteiro ainda restam hoje (se membro).
Inputs: token (required).
Status atual de um pedido (aguardando_pagamento, reservado, cancelado, falhou),
o NUMERO DE CONFIRMACAO (codigo, formato CUN4-XXXXXXXX — e o que o hospede guarda e
cita ao suporte), o localizador do hotel (booking_id) quando ja reservado, e se o
voucher ja esta pronto. order_id aceita o id do pedido (ord_...) ou o numero de
confirmacao. Use para acompanhar se o pagamento ja confirmou a reserva.
Inputs: token (required), order_id (required).
Recotacao ao vivo de UM quarto especifico (preco final revalidado, politica de cancelamento, prazo-limite para cancelar de graca, observacoes do quarto). Chame isso antes de create_payment para confirmar com o hospede o preco e a politica exatos antes de cobrar.
Inputs: token (required), opcao_id (required), search_id (required).
Voucher completo (HTML) de uma reserva ja confirmada — mostre/descreva ao hospede ou oriente a salvar/imprimir para o check-in. So funciona apos a reserva estar com status 'reservado' (confira com get_order_status antes).
Inputs: token (required), order_id (required).
Cupom pessoal de desconto ainda disponivel do hospede (ex.: o cupom de boas-vindas do primeiro cadastro), se houver. Retorna {cupom: null} se nao houver nenhum ativo.
Inputs: token (required).
Inicia a assinatura anual do Clube Cancun4me (USD 1.000/ano, renovacao automatica —
20% da primeira reserva de volta em credito, 10% das seguintes, + assistente de
roteiro). Nao ha desconto imediato: os creditos valem na reserva SEGUINTE. Devolve um payment_url do Stripe
Checkout — o hospede abre e assina na pagina segura do Stripe; nunca colete dados de
pagamento aqui. Falha se o hospede ja for membro (confira antes com get_membership_status).
Inputs: token (required).
Lista o catalogo curado de hoteis do Cancun4me (nome, zona, descricao, destaques, fotos), sem precisar de datas ou chave pessoal. Bom para descobrir/descrever hoteis antes de o hospede escolher datas. language: 'en', 'pt' ou 'es'.
Inputs: language.
Lista todas as reservas do hospede (passadas e futuras), com status, hotel,
numero de confirmacao (codigo, CUN4-XXXXXXXX; reservas antigas nao tem), datas,
preco e se ainda da para cancelar de graca (cancelavel_gratis).
Inputs: token (required).
Busca tarifas AO VIVO (sempre em tempo real, nunca cache) nos hoteis do catalogo
Cancun4me para as datas informadas, agrupadas por hotel (menor preco de cada um —
o 'a partir de'). Sempre pelo menos 1 adulto; children_ages e a lista de idades das
criancas (uma por crianca), ex.: [7, 12]. destino_ou_hotel filtra por nome (opcional).
Guarde o search_id da resposta — ele e necessario em ver_quartos, get_quote e
create_payment (a busca fica valida por um tempo limitado; se expirar, refaca).
Datas no formato YYYY-MM-DD. Precos ja incluem o desconto do tier do hospede
(cadastrado 8% / vip 12%) e o markup de venda — sao os precos finais de compra. Membro do
Clube nao tem desconto imediato no preco: o beneficio e credito pos-confirmacao (20% da
primeira reserva, 10% das seguintes) para a proxima reserva.
Inputs: token (required), checkin (required), checkout (required), adults, +3 more.
Lista TODOS os apartamentos/tipos de quarto disponiveis de UM hotel dentro de uma
busca ja feita (use o search_id e o hotel_slug devolvidos por search_hotels). Cada
quarto tem um opcao_id — use-o em get_quote e create_payment.
Inputs: token (required), search_id (required), hotel_slug (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Search, quote and book hotels worldwide from your AI assistant. Live rates, pay in USD or BRL.
Portal de reservas: consulta datas, solicita reserva e retorna link de pagamento.
Search, quote and book hotels and resorts from any AI agent. Checkout on tellandgo.com. No API key.
Hotéis, pousadas e hostels do Booking Brasil com e-mail, telefone, razão social e CNPJ da Receita.
Add one secure layer between your agents and this server.