Servidor MCP

Cancun4me — Reservas de Hotel

me.cancun4/reservas
Pagos y fintech Viajes y hospitalidad Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches, quotes, books, tracks, cancels, and provides vouchers for hotels in Cancun and Riviera Maya, with Stripe payment links.

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.
Esquema de entrada
{'type': 'object', 'title': 'cancel_bookingArguments', 'required': ['token', 'order_id'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'order_id': {'type': 'string', 'title': 'Order Id'}}}
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).
Esquema de entrada
{'type': 'object', 'title': 'create_paymentArguments', 'required': ['token', 'search_id', 'opcao_id', 'hospedes', 'email_contato'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'hospedes': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Hospedes'}, 'opcao_id': {'type': 'string', 'title': 'Opcao Id'}, 'search_id': {'type': 'string', 'title': 'Search Id'}, 'voucher_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Voucher Code', 'default': None}, 'email_contato': {'type': 'string', 'title': 'Email Contato'}}}
get_hotel_info
Detalhe de UM hotel do catalogo pelo slug (retornado por list_hotels ou search_hotels). language: 'en', 'pt' ou 'es'.
Esquema de entrada
{'type': 'object', 'title': 'get_hotel_infoArguments', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'title': 'Slug'}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}}}
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).
Esquema de entrada
{'type': 'object', 'title': 'get_membership_statusArguments', 'required': ['token'], 'properties': {'token': {'type': 'string', 'title': 'Token'}}}
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.
Esquema de entrada
{'type': 'object', 'title': 'get_order_statusArguments', 'required': ['token', 'order_id'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'order_id': {'type': 'string', 'title': 'Order Id'}}}
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.
Esquema de entrada
{'type': 'object', 'title': 'get_quoteArguments', 'required': ['token', 'search_id', 'opcao_id'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'opcao_id': {'type': 'string', 'title': 'Opcao Id'}, 'search_id': {'type': 'string', 'title': 'Search Id'}}}
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).
Esquema de entrada
{'type': 'object', 'title': 'get_voucherArguments', 'required': ['token', 'order_id'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'order_id': {'type': 'string', 'title': 'Order Id'}}}
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.
Esquema de entrada
{'type': 'object', 'title': 'get_welcome_couponArguments', 'required': ['token'], 'properties': {'token': {'type': 'string', 'title': 'Token'}}}
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).
Esquema de entrada
{'type': 'object', 'title': 'join_clubArguments', 'required': ['token'], 'properties': {'token': {'type': 'string', 'title': 'Token'}}}
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'.
Esquema de entrada
{'type': 'object', 'title': 'list_hotelsArguments', 'properties': {'language': {'type': 'string', 'title': 'Language', 'default': 'en'}}}
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).
Esquema de entrada
{'type': 'object', 'title': 'list_my_bookingsArguments', 'required': ['token'], 'properties': {'token': {'type': 'string', 'title': 'Token'}}}
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.
Esquema de entrada
{'type': 'object', 'title': 'search_hotelsArguments', 'required': ['token', 'checkin', 'checkout'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'adults': {'type': 'integer', 'title': 'Adults', 'default': 2}, 'checkin': {'type': 'string', 'title': 'Checkin'}, 'checkout': {'type': 'string', 'title': 'Checkout'}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}, 'children_ages': {'anyOf': [{'type': 'array', 'items': {'type': 'integer'}}, {'type': 'null'}], 'title': 'Children Ages', 'default': None}, 'destino_ou_hotel': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Destino Ou Hotel', 'default': None}}}
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.
Esquema de entrada
{'type': 'object', 'title': 'ver_quartosArguments', 'required': ['token', 'search_id', 'hotel_slug'], 'properties': {'token': {'type': 'string', 'title': 'Token'}, 'search_id': {'type': 'string', 'title': 'Search Id'}, 'hotel_slug': {'type': 'string', 'title': 'Hotel Slug'}}}
Añadido
join_club
17 de September de 2026 a las 12:54
Añadido
get_membership_status
17 de September de 2026 a las 12:54
Añadido
get_welcome_coupon
17 de September de 2026 a las 12:54
Añadido
cancel_booking
17 de September de 2026 a las 12:54
Añadido
get_voucher
17 de September de 2026 a las 12:54
Añadido
list_my_bookings
17 de September de 2026 a las 12:54
Añadido
get_order_status
17 de September de 2026 a las 12:54
Añadido
create_payment
17 de September de 2026 a las 12:54
Añadido
get_quote
17 de September de 2026 a las 12:54
Añadido
ver_quartos
17 de September de 2026 a las 12:54
Añadido
search_hotels
17 de September de 2026 a las 12:54
Añadido
get_hotel_info
17 de September de 2026 a las 12:54
Añadido
list_hotels
17 de September de 2026 a las 12:54