Lodgify a MCP: reservas de alquiler vacacional, disponibilidad, tarifas, presupuestos y mensajes a huéspedes en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Lodgify, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Lodgify

Gestión de alquiler vacacional con Lodgify: alojamientos y tipos de habitación, calendarios de disponibilidad, tarifas por noche y presupuestos, reservas y consultas, conversaciones con huéspedes, check-in y check-out, códigos de acceso y cambios de estado de las reservas. Funciona con la clave Public API de la cuenta.

Configuración

La configuración lleva unos 2 minutos. Necesitas al propietario de la cuenta de Lodgify, porque solo él ve la clave API.

1. En Lodgify (https://app.lodgify.com) abre Settings > Public API y copia la clave API.
2. Pégala en LODGIFY_API_KEY. Se envía en la cabecera X-ApiKey.
3. Instala el conector y ejecuta lodgify_list_properties para comprobar la clave.

La clave da acceso completo a la cuenta: todos los que usan este conector trabajan con cada alojamiento, reserva y conversación con huéspedes de la cuenta.

Qué lee:

• Alojamientos y tipos de habitación: lodgify_list_properties, lodgify_get_property, lodgify_list_property_rooms (los ids de tipo de habitación que necesitan tarifas, disponibilidad, presupuestos y reservas), lodgify_get_room, alojamientos eliminados desde una fecha y los extras y formas de pago de un alojamiento.
• Disponibilidad: el calendario de toda la cuenta, de un alojamiento o de un tipo de habitación para un periodo, opcionalmente con las reservas y periodos cerrados que bloquean las fechas.
• Precios: tarifas por noche y estancia mínima por día (lodgify_get_rates_calendar), ajustes de tarifa (impuestos, cargos, depósito, reglas de cancelación, precio por huésped adicional) y lodgify_get_quote, el total de una posible estancia con tarifa, cargos, impuestos, extras y código promocional.
• Reservas: lodgify_list_bookings con stay_filter Upcoming, Current, Historic, All, o ArrivalDate y DepartureDate junto con stay_filter_date (por ejemplo las llegadas de hoy); lodgify_get_booking con huésped, habitaciones, totales, importe pagado y pendiente, notas, códigos de acceso y la conversación; reservas de canales vinculadas (Airbnb, Booking.com, Vrbo, ...); el presupuesto de la reserva y el enlace de pago para el huésped.
• Bandeja de entrada: lodgify_list_inbox (reservas y consultas juntas, de la más reciente a la más antigua), lodgify_count_unread, lodgify_get_enquiry y lodgify_get_thread con el thread_uid de una reserva o consulta.

Qué escribe:

• Nueva reserva: la IA comprueba lodgify_get_room_type_availability y lodgify_get_quote y luego llama a lodgify_create_booking. Ahí Lodgify ignora el estado, así que la IA confirma después la reserva con lodgify_set_booking_booked o retiene las fechas con lodgify_set_booking_tentative. Con from_enquiry_id una consulta existente se convierte en la reserva.
• Cambios de estado: lodgify_decline_booking (las fechas vuelven a quedar libres) y lodgify_reopen_booking (vuelve a Open; una reserva Booked libera sus fechas).
• Llegada y salida: lodgify_update_key_codes fija los códigos de la puerta o de la caja de llaves que ve el huésped; lodgify_check_in_booking y lodgify_check_out_booking registran la hora de llegada y de salida.
• Mensajes: lodgify_add_booking_messages y lodgify_add_enquiry_messages añaden mensajes a una conversación; el tipo Comment guarda una nota interna que el huésped no ve. lodgify_mark_booking_replied y lodgify_mark_booking_not_replied clasifican la conversación en la bandeja de entrada.

Emails a huéspedes: los mensajes con send_notification: true, lodgify_request_payment y request_payment: true en un cambio de estado envían un email al huésped. La IA te muestra el texto y espera tu sí antes de enviarlo.

Desactivadas al instalar: ninguna herramienta. El conector no tiene herramientas de borrado y una reserva rechazada se puede reabrir con lodgify_reopen_booking.

Formatos de datos: los ids de alojamientos, tipos de habitación y reservas son enteros; una conversación es un GUID (thread_uid). Las fechas son YYYY-MM-DD; las horas de check-in y check-out son HH:mm:ss en la zona horaria del alojamiento; las fechas de modificación son ISO 8601. Los importes van en la moneda del alojamiento (currency_code), en unidades enteras (120.5 = 120,50). El estado de una reserva es Open (una solicitud), Tentative, Booked o Declined; source indica el canal (Manual, AirbnbIntegration, BookingCom, ...).

Paginación: las listas v2 aceptan page (desde 1) y size (50 por defecto); con include_count: true el total llega en count. lodgify_list_inbox usa offset y limit y devuelve total.

Errores frecuentes: 401 o 403 significa una clave API ausente o incorrecta, 404 un id desconocido, 400 fechas o parámetros no válidos (el cuerpo de la respuesta dice cuáles). 429 es el límite de peticiones: la IA espera y vuelve a intentarlo.

El conector no cambia tarifas ni disponibilidad, no crea enlaces de pago, no gestiona webhooks y no mueve reservas a la papelera.

Requisitos previos: LODGIFY_API_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Lodgify e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién llega hoy a nuestros alojamientos? Muéstrame nombre del huésped, alojamiento, número de personas e importe pendiente."
• "¿Está libre el Sea View Apartment del 12 al 19 de julio para 2 adultos y un perro? ¿Cuánto costaría la estancia?"
• "¿Qué mensajes de huéspedes siguen sin respuesta? Resume cada conversación."
• "Pon el código de la caja de llaves 4821 en la reserva 1234567 y redacta un mensaje de check-in para el huésped. Enséñamelo antes de enviarlo."
• "Crea una reserva para Laura Bianchi en el Garden Studio del 3 al 7 de marzo y confírmala."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT