Nomad Stays
La plataforma mundial para encontrar y reservar alojamiento amigable para nómadas digitales
Documentación
📖 Resumen
El servidor MCP de Nomad Stays brinda a asistentes de IA como Claude y ChatGPT acceso a una base de datos curada de alojamientos aptos para trabajo remoto y nómadas digitales en todo el mundo a través del Protocolo de Contexto de Modelo (MCP) — y, para los Trusted Stay Partners autenticados, permite que su propio asistente de IA gestione sus listados directamente.
Los nómadas digitales y los trabajadores remotos también pueden usar su propio asistente de IA para explorar Nomad Stays directamente en la conversación: crear una cuenta, luego buscar la estancia o experiencia adecuada por ubicación, estilo de vida, presupuesto, comodidades o velocidad de WiFi, y verificar la disponibilidad de habitaciones para sus fechas — luego dirígete a nomadstays.com para completar la reserva y el pago.
Los Trusted Stay Partners pueden conectar su propio asistente de IA (consulte Configuración de su asistente de IA como Trusted Stay Partner a continuación) para que pueda buscar y actualizar sus listados de Stay, habitaciones, paquetes de precios, datos organizativos, perfil de negocio y fotos en su nombre. Consulte las secciones 🔐 Herramientas de consulta con alcance de propietario y ✏️ Herramientas de escritura con alcance de propietario a continuación.
👥 Nómadas y Stay Partners
Lo que cada tipo de usuario puede hacer
🤖 Protocolo MCP
Úselo con asistentes de IA como Claude
💡 Ejemplos
Vea ejemplos de solicitudes y respuestas
🆘 Centro de ayuda
Acceda a artículos de ayuda y soporte a través de las herramientas MCP
📊 Modelo de datos
Comprenda la estructura del objeto stay
🏨 Integración de proveedores
Envíe su disponibilidad a Nomad Stays en tiempo real
👥 Lo que puede hacer
Este servidor MCP atiende a dos tipos de usuarios. Elija la columna que coincida con usted:
🧳 Nómadas digitales y trabajadores remotos
Cualquier persona que busque un lugar para alojarse y trabajar.
- Cree una cuenta de Nomad Stays desde la conversación
- Busque estancias por país, continente, ciudad, estilo de vida, presupuesto, comodidades o velocidad de WiFi
- Verifique la disponibilidad de habitaciones para fechas específicas, o encuentre las fechas disponibles más cercanas
- Obtenga una cotización de precio en vivo para un paquete de estancia, luego resérvelo y reciba un enlace de pago alojado para pagar
- Verifique el estado de pago de una reserva por PNR
- Liste todas sus reservas pasadas y futuras
- Busque respuestas en el Centro de ayuda, o navegue por las categorías de ayuda
🏡 Trusted Stay Partners
Cualquier persona que liste o quiera listar una propiedad con Nomad Stays.
- Inicie, guarde y envíe una nueva solicitud de Stay, Experience o Coworking
- Pague la tarifa de solicitud y verifique su estado de pago
- Liste sus propias estancias y verifique la puntuación de finalización del listado de cada una
- Vea y actualice los detalles de Stay, habitaciones, paquetes de precios y datos organizativos
- Gestione las fotos de Stay y de las habitaciones: cargue, elimine y reordene
- Vea y actualice su perfil de negocio
- Consulte datos de referencia (tipos de habitación, instalaciones, monedas, políticas de cancelación, etc.) necesarios para completar lo anterior
Las herramientas de Trusted Stay Partner requieren conectar un asistente de IA con un inicio de sesión de Nomad Stays — consulte Configuración de su asistente de IA como Trusted Stay Partner a continuación.
🤖 Model Context Protocol (MCP)
Este servidor implementa la especificación MCP, permitiendo a los asistentes de IA descubrir y usar datos de estancias de forma natural en la conversación. Ahora incluye herramientas del Centro de ayuda para buscar y recuperar artículos de soporte directamente a través de MCP.
🚀 Configuración rápida para Claude Desktop
Conecte este servidor a Claude Desktop en un par de clics — no necesita editar archivos de configuración:
Paso 1: En Claude Desktop, vaya a Configuración → Conectores y haga clic en Agregar conector personalizado.
Paso 2: Ingrese la URL del servidor:
https://mcp.nomadstays.com/mcp
Claude Desktop abrirá un mensaje de inicio de sesión — inicie sesión con su cuenta de Nomad Stays y haga clic en Permitir. Luego puede preguntar: "Encuéntrame estancias de trabajo remoto en Portugal"
Para usuarios web de Claude.ai y ChatGPT
- Vaya a Configuración → Conectores (Claude.ai) o a la configuración equivalente de conector/MCP en ChatGPT
- Haga clic en "Agregar conector personalizado" / "Agregar servidor"
- Ingrese la URL del servidor:
https://mcp.nomadstays.com/mcp - Complete el mensaje de inicio de sesión de Nomad Stays y haga clic en Permitir, ¡luego comience a usarlo en las conversaciones!
POST / Protocolo MCP
Punto final del protocolo MCP para la integración con asistentes de IA.
Integración
Para usar este servidor con Claude u otros asistentes compatibles con MCP, configure su cliente MCP con:
{ "mcpServers": { "nomadstays": { "url": "https://mcp.nomadstays.com/mcp" } } }
🔑 Configuración de su asistente de IA como Trusted Stay Partner (Paso a paso)
Si gestiona una estancia en Nomad Stays, puede permitir que su propio asistente de IA lea y actualice su listado, habitaciones, precios y fotos por usted. No necesita saber programar — es una conexión de autoservicio usando su inicio de sesión de Nomad Stays, sin esperar al equipo de Nomad Stays. Esto funciona con ChatGPT, Claude.ai y los Conectores de Claude Desktop.
Paso 1 — Active la autenticación de dos factores
Antes de poder conectar un agente, su cuenta de Nomad Stays necesita tener activada la autenticación de dos factores (2FA). Esto protege su listado en caso de que el acceso se pierda o se comparta. Vaya a Activar la autenticación de dos factores y siga las instrucciones en pantalla si aún no lo ha hecho.
Paso 2 — Agregue el conector en su asistente de IA
En ChatGPT o Claude.ai, agregue un nuevo conector/servidor MCP que apunte a https://mcp.nomadstays.com/mcp. En Claude Desktop, agréguelo en Configuración → Conectores en su lugar. Su asistente abrirá un mensaje de inicio de sesión y autorización de Nomad Stays — inicie sesión y haga clic en Permitir. El acceso se concede de inmediato, y puede revisar o revocar agentes conectados en cualquier momento desde su página de Información del operador.
Paso 3 — Pruébelo
Inicie una nueva conversación y pregunte algo como: "Lista mis estancias" o "Muéstrame los paquetes de precios actuales en mi estancia." Si su asistente responde con sus datos reales de listado, está funcionando.
¿Preguntas? Contáctenos.
Herramientas disponibles
| Nombre de la Herramienta | Descripción | Parámetros |
|---|---|---|
| 🆘 Herramientas del Centro de Ayuda | ||
searchHelpCenter | Buscar artículos de ayuda por palabra clave o pregunta | query (cadena), category (cadena opcional), limit (número opcional) |
getHelpCenterArticle | Recuperar un artículo de ayuda específico por ID | id (cadena) |
listHelpCenterCategories | Listar todas las categorías disponibles del centro de ayuda | Ninguno |
| 🔍 Herramientas de Búsqueda y Filtrado | ||
getStaysByCountry | Buscar estancias por código de país de 2 letras o nombre parcial del país | countrycode (cadena), limit (número) |
getStaysByContinent | Filtrar estancias por continente (Europa, Asia, África, etc.) | continent (cadena), limit (número) |
getStaysByLocation | Buscar en ciudad, estado, nombre de ubicación, país y descripción | location (cadena), limit (número) |
getStaysByLifestyle | Encontrar estancias por categoría de estilo de vida | lifestyle (cadena), limit (número) |
getStaysByBudget | Buscar estancias dentro de un presupuesto y duración con conversión de divisas | durationDays, maxPrice, currency, countryCode (opcional), checkInDate (opcional), limit (opcional) |
getStaysByAmenities | Buscar estancias por comodidades con coincidencia difusa | amenities (matriz), matchType (opcional), minWifiSpeed (opcional), limit (opcional) |
getStaysByWiFiSpeed | Encontrar todas las estancias con velocidad de descarga de WiFi superior a 10Mbps. | minWiFiDownloadSpeed (número), limit (número) |
getStayByID | Obtener información detallada sobre una estancia específica | id (número) |
| 👤 Herramientas de Cuenta | ||
signupNomadStaysAccount | Crear una nueva cuenta de Nomad Stays para alguien que aún no tiene una. La cuenta permanece inactiva hasta que la persona haga clic en el enlace de confirmación enviado por correo electrónico; no se devuelve ninguna sesión ni token | firstName, lastName, email, telephone, password, acceptGdpr |
| 📅 Herramientas de Disponibilidad y Reserva | ||
checkStayAvailability | Verificar disponibilidad de habitaciones para fechas específicas | stayId, checkIn, checkOut, roomType (opcional) |
findNearestAvailability | Encontrar las fechas disponibles más cercanas a la fecha de entrada preferida | stayId, preferredCheckIn, minLengthOfStay, maxLengthOfStay (opcional), searchWindowDays (opcional) |
getAvailabilityByMonth | Obtener el calendario de disponibilidad para un mes específico | stayId, year, month, minLengthOfStay |
getRoomAvailability | Verificar disponibilidad para una habitación específica | roomId, checkIn, checkOut |
| 🧳 Herramientas de Reserva de Estancias (requieren un token de agente MCP con el alcance "bookings") | ||
quoteStayBooking | Obtener una cotización de precio y disponibilidad calculada por el servidor para reservar un paquete de Estancia en nombre del solicitante. El precio siempre se vuelve a derivar de los niveles de precios reales del paquete. Devuelve un quoteId válido por aproximadamente 15 minutos | packageId, checkIn, checkOut, rooms (opcional), adults (opcional), children (opcional), pets (opcional) |
bookStay | Crear una reserva real a partir de un quoteId devuelto por quoteStayBooking y devolver una checkoutUrl alojada. El miembro debe abrir la checkoutUrl por sí mismo para pagar; ningún dato de tarjeta pasa por el asistente | quoteId, contactName (opcional), contactEmail (opcional), contactPhone (opcional), specialRequest (opcional) |
getBookingStatus | Verificar el estado real de pago de una reserva de Estancia por PNR. El estado siempre se vuelve a verificar directamente contra Airwallex si aún no se ha confirmado como pagado | pnr |
listMyBookings | Listar todas las reservas de Estancia propiedad de la cuenta del solicitante, las más recientes primero. Cada reserva incluye needsAction: true si aún no está pagada, con una checkoutUrl lista para usar | Ninguno |
| 📚 Herramientas de Referencia y Metadatos | ||
getAllLifestyles | Recuperar todas las categorías de estilo de vida disponibles | Ninguno |
getAllAmenities | Recuperar todas las comodidades disponibles en el sistema | Ninguno |
getRoomAmenities | Obtener comodidades para una habitación específica | roomId |
| 🔐 Herramientas de Consulta con Alcance de Propietario (requieren un token de agente MCP) | ||
getMyStays | Listar todas las Estancias propiedad de la cuenta vinculada al token de agente MCP | Ninguno |
getMyStayDetail | Obtener el título actual, la descripción y el estado de publicación de una Estancia | stayId |
getMyStayOnboardingStatus | Obtener las seis puntuaciones de "Finalización del Anuncio" de la Estancia (Detalles de la Estancia, Disponibilidad, Habitaciones, Paquetes, Wi-Fi, Información del Operador) más un porcentaje de finalización general. Wi-Fi es una puntuación de frescura de prueba, no una calificación de velocidad; Información del Operador es una etiqueta de estado ("Abierto"), no un porcentaje real | stayId |
getMyStayRooms | Listar todas las habitaciones configuradas en una Estancia | stayId |
getMyStayPackages | Listar todos los paquetes de precios y niveles de precios en una Estancia | stayId |
getMyStayOrganisationalData | Obtener la dirección de una Estancia, la política de entrada/salida y la política de cancelación | stayId |
getMyStayContacts | Obtener los datos de contacto públicos de una Estancia | stayId |
getMyStayFacilities | Obtener las casillas de verificación de instalaciones de una Estancia para un grupo de instalaciones determinado | stayId, group |
getMyStayPhotos | Listar las fotos de una Estancia por área (anuncio, principal, espacio de trabajo, anfitrión) | stayId |
getMyBusinessProfile | Obtener el perfil comercial de la cuenta de Socio de Estancia de Confianza (nombre legal, números de IVA/registro) | Ninguno |
getRoomTypeOptions | Listar los tipos de habitación válidos para una Estancia: las estancias boutique solo obtienen Boutique1–Boutique6, las estancias estándar obtienen tipos de habitación ordinarios | stayId |
getRoomFacilityOptions | Listar todas las opciones de instalaciones a nivel de habitación | Ninguno |
getCurrencyOptions | Listar las monedas válidas para el precio de paquetes | Ninguno |
getBusinessModelOptions | Listar los valores válidos para el modelo de negocio de una Estancia: solo lectura (no editable a través de MCP ni de la interfaz del Panel de Estancias), pero el valor que contiene determina la fórmula de sellPrice y si advertisingEndpoint aplica a packages | None |
getFacilityGroups | Lista todos los grupos de instalaciones en los que se organizan las instalaciones de una estadía | None |
getStayTypeOptions | Lista los valores válidos para el tipo de alojamiento principal de una estadía | None |
getCountryOptions | Lista los países válidos, con nombres y códigos de 2 letras | None |
getCancellationPolicyOptions | Lista los valores válidos de política de cancelación | None |
getAdditionalInformationOptions | Lista los valores válidos para un campo de lista de selección (p. ej., Mascotas permitidas, Niños permitidos, Estacionamiento) utilizado en datos organizativos | filterName |
| ✏️ Herramientas de escritura con alcance del propietario (requieren un token de agente MCP) | ||
updateStayDetail | Actualiza el título y/o la descripción de una estadía | stayId, title (opcional), description (opcional) |
createStayRoom | Crea una nueva habitación en una estadía | stayId, roomTitle, roomDescription (opcional), beds (opcional), maxPerson (opcional) y más |
updateStayRoom | Actualiza una habitación existente en una estadía | stayId, roomId, más cualquier campo de habitación a cambiar |
deleteStayRoom | Elimina de forma suave una habitación de una estadía | stayId, roomId |
createStayPackage | Crea un nuevo paquete de precios en una estadía, opcionalmente con niveles de precio iniciales | stayId, packageName, prices (matriz opcional) y más |
updateStayPackage | Actualiza un paquete de precios. Proporcionar precios reemplaza TODAS las filas de precios de ese paquete | stayId, packageId, más cualquier campo de paquete/precio a cambiar |
deleteStayPackage | Elimina permanentemente un paquete de precios y todos sus niveles de precio (eliminación dura, a diferencia de las habitaciones) | stayId, packageId |
updateStayOrganisationalData | Actualiza la dirección de una estadía, la política de entrada/salida, mascotas/niños/estacionamiento, política de cancelación | stayId, más cualquier campo organizativo a cambiar |
updateStayContacts | Actualiza los datos de contacto públicos de una estadía | stayId, más cualquier campo de contacto a cambiar |
updateStayFacilities | Establece la lista completa de casillas de instalaciones seleccionadas para un grupo de instalaciones en una estadía. Cualquier elemento no incluido se desmarca | stayId, group, facilityDetailIds (lista de reemplazo completa) |
updateHostBusinessProfile | Actualiza el perfil comercial de la cuenta de Trusted Stay Partner. Nunca toca datos personales, bancarios ni de identificación fiscal | businessName, vatNumber, businessNumber, entityAccount — todos opcionales |
uploadStayPhoto | Sube una foto al listado de una estadía, área principal, de trabajo, del anfitrión o de la habitación. Proporciona una URL pública https:// o bytes codificados en base64. Cada foto se valida en formato JPEG/PNG/WebP, tamaño (hasta 20MB), resolución mínima (1920×1080 horizontal, o 1080×1350 vertical para el área "host"), y se reduce a 2560×1440 y se recodifica como WebP en el servidor antes del almacenamiento | stayId, area, url o base64, roomId (obligatorio cuando el área es "room") |
deleteStayPhoto | Elimina una foto a nivel de estadía por área y nombre de archivo | stayId, area, fileName |
reorderStayPhotos | Reordena las fotos de una estadía dentro de un área determinada | stayId, area, fileNames (lista ordenada completa) |
deleteRoomPhoto | Elimina una foto a nivel de habitación por área y nombre de archivo | stayId, roomId, roomArea, fileName |
reorderRoomPhotos | Reordena las fotos de una habitación dentro de un área determinada | stayId, roomId, roomArea, fileNames (lista ordenada completa) |
| 💳 Herramientas de pago de productos (requieren un token de agente MCP) | ||
getProductInfo | Consulta el precio y la disponibilidad de compra de un producto — producto 8 (Solicitud de estadía) o producto 9 (Solicitud de experiencia), ambos EUR 39 | productId |
purchaseProduct | Inicia una compra en nombre del solicitante. Devuelve una checkoutUrl que el miembro debe abrir y pagar por sí mismo, o se resuelve inmediatamente como "waived" si el solicitante ya califica para una exención de tarifa | productId (8 para Solicitud de estadía, 9 para Solicitud de experiencia), applicationId (opcional — correlaciona el pago con la solicitud) |
getPurchaseStatus | Verifica si una compra ha sido pagada — solo informa "paid" después de una verificación nueva en el servidor contra el proveedor de pagos | saleId |
| 📋 Herramientas de solicitudes de estadía (requieren un token de agente MCP) | ||
listStayApplications | Lista las solicitudes de estadía del solicitante (borrador y enviadas), cada una con una sugerencia de nextAction | None |
getStayApplication | Obtiene el estado actual completo de una solicitud de estadía, incluidos nextAction y (si está incompleta) missingFields | applicationId |
createStayApplication | Inicia una nueva solicitud de estadía. Cualquier campo puede proporcionarse ahora o completarse más tarde mediante saveStayApplication | Todos los campos opcionales — consulta los campos de solicitante, dirección, estadía y propiedad a continuación |
saveStayApplication | Actualiza cualquier subconjunto de campos en una solicitud existente aún no enviada | applicationId, más cualquier campo de createStayApplication a cambiar |
submitStayApplication | Envía una solicitud completada para revisión humana. Rechaza con missingFields si está incompleta, o con un 409 si la tarifa de solicitud (producto 8) no está pagada/exenta aún | applicationId |
| 🧭 Herramientas de solicitudes de experiencia (requieren un token de agente MCP) | ||
listExperienceApplications | Lista las solicitudes de experiencia del solicitante (borrador y enviadas), cada una con una sugerencia de nextAction | None |
getExperienceApplication | Obtiene el estado actual completo de una solicitud de experiencia, incluidos nextAction y (si está incompleta) missingFields | applicationId |
createExperienceApplication | Inicia una nueva solicitud de experiencia. Las experiencias deben durar un mínimo de 4 días (aplicado en el servidor) | Todos los campos opcionales — consulta los campos de solicitante, dirección y detalles de experiencia |
saveExperienceApplication | Actualiza cualquier subconjunto de campos en una solicitud existente aún no enviada | applicationId, más cualquier campo de createExperienceApplication a cambiar |
submitExperienceApplication | Envía una solicitud completada para revisión humana. Rechaza con missingFields si está incompleta, o con un 409 si la tarifa de solicitud (producto 9, NO el producto 8) no está pagada/exenta aún | applicationId |
| 🏢 Herramientas de solicitudes de coworking (requieren un token de agente MCP) | ||
listCoworkingApplications | Lista las solicitudes de coworking del solicitante (borrador y enviadas), cada una con una sugerencia de nextAction hint | None |
getCoworkingApplication | Obtén el estado completo actual de una Solicitud de Coworking, incluyendo nextAction y (si está incompleta) missingFields | applicationId |
createCoworkingApplication | Inicia una nueva Solicitud de Coworking. Mucho más simple que Stay/Experience: sin reglas de IVA, turismo o modelo de negocio, y sin Tarifa de Solicitud en absoluto — nextAction va directamente a enviar una vez que coworkingName, applicantName, applicantEmail, city y country estén presentes | Todos los campos son opcionales — coworkingName, applicantName, applicantEmail, telephone, address, city, country, website |
saveCoworkingApplication | Actualiza cualquier subconjunto de campos en una solicitud existente que aún no haya sido enviada | applicationId, más cualquiera de los campos de createCoworkingApplication que se deseen cambiar |
submitCoworkingApplication | Envía una solicitud completada para revisión humana. Rechaza con missingFields si está incompleta. No hay Tarifa de Solicitud para Coworking, por lo que esto nunca devuelve una respuesta de pago requerido | applicationId |
📊 Modelo de Datos
Objeto Stay
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único de la estancia |
name | string | Nombre del alojamiento |
description | string | Descripción breve de la estancia |
country | string | Nombre completo del país |
countryCode | string | Código de país ISO 3166-1 alfa-2 |
city | string | Nombre de la ciudad |
priceRange | string | Rango de precio semanal (p. ej., "Desde EUR 250 por semana") |
priceCurrency | string | Código de moneda (p. ej., EUR, USD) |
amenities | array | Lista de comodidades disponibles |
WiFiDownloadSpeed | number | Velocidad de descarga WiFi en Mbps (opcional) |
WiFiUploadSpeed | number | Velocidad de subida WiFi en Mbps (opcional) |
location_name | string | Nombre de la ubicación de la tabla Location |
location_country | string | País de la ubicación de la tabla Location |
PetsAllowed | boolean | Si se permiten mascotas |
coordinates | object | Coordenadas GeoLat y GeoLng |
bookingUrl | string | URL para reservar la estancia |
Comodidades Comunes
Identificadores estándar de comodidades utilizados en la API:
high_speed_wifi- Conexión a internet de alta velocidaddedicated_desk- Espacio de trabajo dedicadokitchen- Acceso completo a la cocinacoworking_space- Espacio de coworking en el lugargym- Instalaciones de fitnesspool- Piscinaparking- Aparcamiento disponiblepet_friendly- Se permiten mascotas
💡 Ejemplos de Uso
Buscar estancias en Portugal
curl "https://mcp.nomadstays.com/api/stays?countrycode=PT&limit=10"
Buscar en el Centro de Ayuda preguntas sobre WiFi
# Usando la herramienta MCP: searchHelpCenter # Ejemplo: Buscar artículos de ayuda sobre WiFi { "tool": "searchHelpCenter", "parameters": { "query": "WiFi" } }
Buscar estancias en Europa
# Usando la herramienta MCP: getStaysByContinent # Busca por nombre de continente
Buscar estancias en París o cerca de playas
# Usando la herramienta MCP: getStaysByLocation # Busca en ciudad, estado, nombre de ubicación y descripciones
Obtener todas las estancias (sin filtro)
curl "https://mcp.nomadstays.com/api/stays?limit=50"
Obtener detalles de una estancia específica
curl "https://mcp.nomadstays.com/api/stays/stay\_001"
Uso con Claude (MCP)
Una vez configurado, simplemente pregunta a Claude de forma natural:
"¿Puedes ayudarme a encontrar alojamientos para trabajo remoto en Tailandia?"
"Muéstrame estancias en París con buen WiFi"
"Quiero alojarme cerca de una playa en Europa"
🆘 Integración con el Centro de Ayuda
El servidor MCP ahora proporciona acceso directo al Centro de Ayuda de Nomad Stays. Puedes buscar artículos de ayuda, recuperar artículos específicos por ID y listar las categorías disponibles utilizando las nuevas herramientas MCP. Esto permite que los asistentes de IA y los usuarios obtengan soporte y respuestas a preguntas comunes de forma programática.
- Usa
searchHelpCenterpara encontrar artículos por palabra clave o pregunta. - Usa
getHelpCenterArticlepara obtener un artículo específico por su ID. - Usa
listHelpCenterCategoriespara explorar los temas de ayuda disponibles.
Para navegación manual, visita el Centro de Ayuda de Nomad Stays.
🌍 Países Soportados
Códigos de país actualmente disponibles (ejemplos):
PT - Portugal
ES - España
TH - Tailandia
MX - México
CO - Colombia
ID - Indonesia
GR - Grecia
IT - Italia
Nota: Usa la API para descubrir la lista completa de países disponibles.
🏨 Integración con Proveedor / PMS
Si operas un sistema de gestión de propiedades (PMS) o un channel manager, puedes sincronizar tu calendario de disponibilidad directamente con Nomad Stays. Hay dos modos de integración disponibles:
Opción 1 — Servidor MCP (Pull)
Ejecuta tu propio servidor MCP que exponga una herramienta get_allocation. Nomad Stays lo consulta cada hora y escribe la disponibilidad devuelta en nuestro sistema de reservas automáticamente.
- Expón tu servidor a través de HTTPS (Streamable HTTP
POST /mcppreferido) - Implementa la herramienta
get_allocation— tomaproperty_id,start_date,end_date - Devuelve un array
rangessolo con los períodos de fecha de asignación reducida - Asegura con un token Bearer — Nomad Stays envía
Authorization: Bearer <key>en cada solicitud
Opción 2 — Push por Webhook (Recomendado)
Envía los cambios de disponibilidad a Nomad Stays en el momento en que ocurren — sin esperar al siguiente ciclo de consulta. Cuando el push por webhook está habilitado, Nomad Stays reduce la consulta a una verificación de seguridad diaria.
POST /api/mcp/availability-push/{stayId} Base: https://www.nomadstays.com
Autenticación
Firma cada solicitud con HMAC-SHA256 usando el secreto compartido que Nomad Stays proporciona durante la incorporación:
X-NomadStays-Signature: sha256=<lowercase-hex>
# Python example
import hmac, hashlib
sig = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
Payload
{
"room_id": "your-room-identifier",
"ranges": [
{ "start_date": "2026-07-10", "end_date": "2026-07-15", "allocation": 0 },
{ "start_date": "2026-08-01", "end_date": "2026-08-05", "allocation": 1 }
]
}
Solo incluye rangos de fechas donde la disponibilidad esté reducida respecto a lo normal. Envía "ranges": [] para eliminar todos los bloqueos.
Códigos de Respuesta
| Estado | Significado |
|---|---|
200 OK | Aceptado — {"received": true, "reductions": N} |
401 | Firma faltante o incorrecta |
404 | Estancia o habitación no encontrada |
Para la especificación completa de integración, incluidos ejemplos de código en Python y Node.js, contáctanos para comenzar la incorporación.
⚡ Límites de Velocidad y Buenas Prácticas
- Límite de velocidad: 100 solicitudes por minuto por IP
- Usa parámetros de límite apropiados para evitar la sobrecarga de datos
- Almacena en caché las respuestas cuando sea posible para reducir las llamadas a la API
- Siempre verifica el endpoint de salud antes de realizar solicitudes masivas
🆘 Soporte
Para preguntas, problemas o solicitudes de funciones:
- Contacto: Página de Contacto
Servidor MCP de Nomad Stays v0.7.0 | Hecho para nómadas digitales y trabajadores remotos 🌎