MCP Guesty: 39 Herramientas Abiertas

El servidor MCP para Guesty abre 39 herramientas que permiten a agentes de IA como Claude gestionar propiedades automáticamente: check-in, comunicación con huéspedes, precios, tareas y webhooks, todo sin código adicional. Es código abierto y funciona en Claude, Cursor y Windsurf.

Qué es el Servidor MCP para Guesty

El Model Context Protocol (MCP) es un protocolo abierto creado por Anthropic que estandariza la forma en que agentes de IA se conectan a herramientas externas. Funcioná pensándolo como un puerto USB-C para inteligencia artificial: en vez de que cada cliente IA (Claude, Cursor, Windsurf) tenga que saber cómo hablar con Guesty, el protocolo MCP traduce la conversación automáticamente.

El servidor MCP de Guesty, desarrollado por DLJ Properties (que gestiona 7 propiedades de alquiler), expone las funcionalidades clave de Guesty como herramientas que un agente de IA puede invocar directamente. Conectás el agente, le decís “hace check-in de esta reserva, enviá un mensaje de bienvenida, actualizá el calendario”, y todo sucede sin intervención manual.

La belleza acá es que no necesitás escribir código de integración personalizado. El servidor ya existe, es open source (en GitHub), y cualquiera con 15 minutos y un plan Guesty Professional puede tenerlo corriendo.

Las 39 Herramientas Disponibles

Ojo: no son 39 herramientas aleatorias. Están organizadas en 6 categorías que cubren el ciclo de vida completo de una propiedad. Cada una tiene parámetros específicos, manejo de errores y casos edge ya pensados.

Gestión de Reservas (11 herramientas)

Crear, leer, actualizar y cancelar reservas. list_reservations trae todas las reservas activas con filtros (por propiedad, fecha, huésped). create_reservation genera una nueva reserva si hay disponibilidad. update_reservation_status cambia el estado (confirmed, checked_in, checked_out). add_reservation_note añade notas privadas que solo vos ves. Hay herramientas específicas para limpiezas, tarifas, y manejo de depósitos de seguridad.

Comunicación con Huéspedes (7 herramientas)

Envío automático de mensajes. send_guest_message manda un WhatsApp, SMS o email. get_guest_inbox trae todos los mensajes pendientes. mark_message_as_read marca como leído. Las herramientas son simples pero potentes: un agente puede leer un mensaje de un huésped, procesarlo, y responder automáticamente sin que vos sepas que sucedió.

Actualización de Calendario y Listados (8 herramientas)

update_availability abre o cierra fechas en el calendario. update_listing_data modifica título, descripción, amenities en Airbnb/Booking. sync_calendar_channel sincroniza múltiples plataformas (si bloqueás una fecha en Airbnb, automáticamente se bloquea en Booking). Esto es critical: un agente puede detectar que una propiedad tiene ocupación baja en verano y ajustar automáticamente el precio y el copy del listado.

Gestión Financiera y Precios (6 herramientas)

get_pricing_rules trae las reglas de precios actuales. update_pricing_rule modifica precios dinámicamente. get_financial_summary retorna ingresos, gastos, margen por propiedad. Un caso de uso real: un agente analiza ocupación de Guesty, compara contra precios en Airbnb, y ajusta tu tarifa automáticamente.

Tareas y Mantenimiento (4 herramientas)

create_task genera tareas de limpieza, mantenimiento o reparación. assign_task asigna a un proveedor. update_task_status marca como completada. Un agente puede programar automáticamente una limpieza 2 horas después del check-out. Relacionado: evaluando la seguridad del código abierto.

Configuración y Webhooks (3 herramientas)

get_webhooks lista los webhooks configurados. create_webhook genera un webhook para notificaciones en tiempo real. Cuando un huésped hace check-in, Guesty notifica automáticamente tu agente IA, que puede responder instantáneamente.

Cómo Funciona la Arquitectura Técnica

El flujo es directo: tu agente IA (Claude en Cursor, por ejemplo) solicita una acción, el protocolo MCP traduce esa solicitud al formato de la API de Guesty, Guesty la ejecuta, y devuelve la respuesta al agente. El servidor MCP maneja internamente la autenticación OAuth2, caché de tokens, y rate limiting.

Requisitos: Node.js 18 o superior, plan Guesty Professional (el plan Starter no da acceso a API), y credenciales OAuth2 generadas en tu dashboard de Guesty. El servidor espera variables de entorno para Client ID y Client Secret.

El manejo de errores viene armado. Si Guesty retorna un 429 (too many requests), el servidor espera automáticamente. Si una reserva no existe, devuelve un error específico que el agente puede procesar. No es “falla genérica”.

Casos de Uso Prácticos en Gestión de Propiedades

Check-in y Check-out Automático

Un huésped llega. Slack notifica al agente IA. El agente consulta la reserva en Guesty, actualiza el status a “checked_in”, envía automáticamente instrucciones de WiFi y códigos de acceso vía WhatsApp, programa una tarea de limpieza para el checkout, y guarda una nota privada con la hora exacta. Todo en 3 segundos.

Mensajes de Bienvenida Inteligentes

Un agente lee el historial de la reserva: ¿es la primera vez que el huésped alquila contigo? ¿Tiene mascotas? ¿Vino con niños? Personaliza el mensaje de bienvenida. No mandás “Bienvenida a nuestra propiedad”, mandás “Hola Carolina, ¡bienvenida! Vemos que traés dos nenes menores de 10. En la casa hay una área de juegos en el patio, toallas para niños, y un high chair en la cocina.” El huésped se siente visto.

Análisis de Ocupación y Optimización de Precios

Cada hora, un agente consulta get_reservations y get_financial_summary. Analiza: ¿qué porcentaje de ocupación tengo en julio? ¿Cuál es el promedio de tarifa por noche? ¿Dónde están los gaps (fechas sin reservar)? El agente ajusta automáticamente pricing_rule. Baja la tarifa en períodos lentos. La sube cuando la ocupación sube. Resultado: ocupación óptima sin que vos hagas nada.

Reportes Financieros Automáticos

Cada viernes, un agente genera un reporte: ingresos brutos, gastos de limpieza, mantenimiento, comisiones de Airbnb, margen neto por propiedad. Lo manda vía email o Telegram. Vos solo lees cifras listas. No perdés tiempo armando spreadsheets. Lo explicamos a fondo en integrándolo con tus herramientas de IA.

Programación Automática de Limpiezas

Un agente detecta que hay 5 check-outs en un día. Crea automáticamente 5 tareas de limpieza, las asigna a tus proveedores según disponibilidad, y manda notificaciones Telegram a cada uno con detalles (tipo de limpieza, dirección, acceso). Los proveedores confirman disponibilidad. Si alguien cancela, el agente reasigna.

Ventajas frente a la Gestión Manual

Disponibilidad 24/7. Cuando un huésped manda un mensaje a las 3 de la mañana, tu agente responde en segundos. Vos dormís.

Reducción de errores humanos. No hay typos en confirmaciones. No hay reservas olvidadas. El sistema es determinístico: si condición X sucede, siempre hace Y. Un humano se distrae, se olvida, comete errores.

Respuesta instantánea. El tiempo entre pregunta y respuesta no depende de cuándo te despiertes. Depende de qué tan rápido es Claude (milisegundos).

Análisis de datos en tiempo real. No esperas a fin de mes para saber cómo va el negocio. En tiempo real, tenés números actualizados, y el agente toma decisiones basadas en eso.

Escalabilidad sin staff. Pasaste de 1 propiedad a 7 (como DLJ Properties). Vos no contrataste 7 operadores. El mismo agente IA maneja todas. El costo marginal es prácticamente cero.

Compatibilidad: Qué Clientes IA Funcionan

El protocolo MCP funciona en cualquier cliente que lo soporte. Hoy, eso incluye Claude Code (la herramienta nativa de Anthropic), Cursor (IDE basado en VS Code), y Windsurf. También funciona como servidor que otros desarrolladores pueden llamar directamente si tienen su propio cliente.

El ecosistema está en crecimiento. Más clientes van a soportar MCP conforme el estándar madure. La ventaja acá es que cuando eso suceda, tu servidor Guesty va a funcionar sin cambios. Escribiste una vez, conectá a cualquier cliente. Cubrimos ese tema en detalle en alternativas para alojar tu repositorio.

Cómo Instalarlo en 5 Pasos

Paso 1: Requisitos Previos

Node.js 18 o superior. Plan Guesty Professional (el plan Starter no da acceso a API). Credenciales OAuth2 generadas en tu dashboard de Guesty (Cliente ID y Cliente Secret).

Paso 2: Clonar el Repositorio

git clone https://github.com/DLJRealty/guesty-mcp-server.git

Luego entra en el directorio: cd guesty-mcp-server

Paso 3: Instalar Dependencias

npm install

Paso 4: Configurar Variables de Entorno

Crea un archivo .env en la raíz del proyecto con tu Guesty Client ID y Client Secret. El servidor va a leerlas automáticamente.

Paso 5: Conectar a tu Cliente IA

En Cursor o Windsurf, configura el MCP server apuntando a localhost (por defecto puerto que especifique el servidor). El cliente IA detecta automáticamente las 39 herramientas disponibles. Listo.

Errores Comunes

1. Confundir MCP con una Integración de Zapier

Zapier también conecta Guesty con otras herramientas. Pero Zapier es “si sucede X en Guesty, haz Y en otra app”. MCP es “un agente IA invoca directamente las herramientas de Guesty mientras está razonando”. Es la diferencia entre automación de flujos y automatización de decisiones. MCP es más poderoso porque el agente puede decidir qué herramienta invocar en función del contexto.

2. Usar Plan Starter en Guesty

El servidor no funciona sin OAuth2. Plan Starter no lo da. Necesitás Professional mínimo. Si lo intentás con Starter, obtenés error 401 (unauthorized) en cada llamada.

3. No Mandar la Credencial de Forma Segura

No hardcodees Client ID y Secret en el código. Usá variables de entorno o un archivo .env (y agregá .env a .gitignore). Si subís credenciales a GitHub, Guesty las revoca automáticamente.

4. Pensar que el Agente IA Gestiona Todo Automáticamente sin Supervisión

El agente es potente, pero no es autónomo infinito. Necesitás human-in-the-loop para decisiones críticas: denegación de un huésped, cambios de precio muy agresivos, refunds. Configurá alertas y umbrales. En cumpliendo estándares de seguridad empresarial profundizamos sobre esto.

Preguntas Frecuentes

¿Qué es exactamente el servidor MCP para Guesty?

Es un adaptador que expone las funcionalidades de Guesty (gestión de reservas, mensajes, calendario, precios, tareas) como herramientas que un agente de IA puede invocar directamente. Funciona bajo el protocolo MCP (Model Context Protocol) de Anthropic, que estandariza cómo los agentes IA hablan con herramientas externas.

¿Tengo que saber programar para usarlo?

No. La instalación requiere 5 pasos básicos: clonar repo, instalar dependencias, configurar credenciales, conectar a tu cliente IA. Si podés copiar un comando de terminal, podés hacerlo. El “programar” lo hace el agente IA después de que está conectado.

¿Cuántas propiedades puedo gestionar?

Ilimitadas. DLJ Properties maneja 7 con un solo agente. No hay límite técnico. El rate limiting de Guesty es el único techo: según la documentación, el plan Professional permite 1.000 requests por hora. Incluso si cada propiedad hace 100 requests por hora, podés manejar 10. La mayoría de negocios no llega a ese volumen.

¿Cuesta dinero usar el servidor MCP?

El servidor en sí es open source y gratuito. Necesitás un plan Guesty Professional (arranca en USD 49/mes aproximadamente, según la región). Además, si usás Claude vía API, pagas por tokens consumidos. Pero comparado con el costo de un operador humano (USD 1.500-2.500/mes mínimo), es una fracción.

¿Qué sucede si Guesty cambia su API?

Los mantenedores del servidor (DLJ Properties y la comunidad) actualizan el servidor. Como es open source en GitHub, está versionado. Si Guesty hace breaking changes, la comunidad lo reporta, y el servidor se actualiza. Vos solo tenés que hacer git pull para tener la última versión.

Conclusión

El servidor MCP para Guesty es una puerta de entrada a la automatización verdadera de la gestión de propiedades. No es una herramienta de “si sucede X, haz Y”. Es un agente IA que raziona, decide, y actúa en tiempo real. 39 herramientas listas para que un agente maneje reservas, comunicación, precios, tareas, todo lo que un operador humano hace, pero 24/7 sin fatiga.

Si manejás 1 propiedad o 10, si estás cansado de responder mensajes a las 3 de la mañana, o si estás buscando escalar sin contratar más gente, esto resuelve el problema. El setup es rápido, el costo es bajo comparado con staff humano, y el código es abierto (si necesitás customizar, podés).

Lo que hacés ahora: instalás, configurás las credenciales de Guesty, conectás tu cliente IA, y dejás que el agente maneje el resto. Es tan directo como eso.

Fuentes

• GitHub – DLJRealty/guesty-mcp-server – Servidor MCP oficial para Guesty
• Guesty Open API Documentation – Referencia técnica completa de endpoints
• Guesty.com – Portal oficial de la plataforma
• Model Context Protocol – Especificación abierta de Anthropic
• Zapier MCP Integrations – Ecosistema de integraciones MCP