# Cancun4me — Reservas de Hotel MCP server

Pesquise, cote e reserve hoteis de Cancun/Riviera Maya direto de uma IA (Cancun4me).

## Links
- Registry page: https://www.getdrio.com/mcp/me-cancun4-reservas

## Install
- Endpoint: https://cancun4-mcp.fly.dev/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://cancun4-mcp.fly.dev/mcp

## Tools
- list_hotels - 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'. Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_hotel_info - Detalhe de UM hotel do catalogo pelo slug (retornado por list_hotels ou
    search_hotels). language: 'en', 'pt' ou 'es'. Endpoint: https://cancun4-mcp.fly.dev/mcp
- search_hotels - 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. Endpoint: https://cancun4-mcp.fly.dev/mcp
- ver_quartos - 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. Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_quote - 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. Endpoint: https://cancun4-mcp.fly.dev/mcp
- create_payment - 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). Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_order_status - Status atual de um pedido (aguardando_pagamento, reservado, cancelado, falhou),
    numero de localizador (booking_id) quando ja reservado, e se o voucher ja esta
    pronto. Use para acompanhar se o pagamento ja confirmou a reserva. Endpoint: https://cancun4-mcp.fly.dev/mcp
- list_my_bookings - Lista todas as reservas do hospede (passadas e futuras), com status, hotel,
    datas, preco e se ainda da para cancelar de graca (cancelavel_gratis). Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_voucher - 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). Endpoint: https://cancun4-mcp.fly.dev/mcp
- cancel_booking - 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 (contact@cancun4.me),
    NAO insista tentando de novo. Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_welcome_coupon - 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. Endpoint: https://cancun4-mcp.fly.dev/mcp
- get_membership_status - 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). Endpoint: https://cancun4-mcp.fly.dev/mcp
- join_club - 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). Endpoint: https://cancun4-mcp.fly.dev/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: me.cancun4
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 4, 2026
- Source: https://registry.modelcontextprotocol.io