Nomad Stays
A plataforma mundial para encontrar e reservar acomodações amigas de nômades digitais.
Documentação
📖 Visão Geral
O MCP Server do Nomad Stays dá a assistentes de IA como Claude e ChatGPT acesso a um banco de dados selecionado de acomodações adequadas para trabalho remoto e nômades digitais ao redor do mundo por meio do Model Context Protocol (MCP) — e, para Trusted Stay Partners autenticados, permite que o próprio assistente de IA deles gerencie seus anúncios diretamente.
Nômades digitais e trabalhadores remotos também podem usar seu próprio assistente de IA para explorar o Nomad Stays diretamente na conversa: crie uma conta, depois pesquise a estadia ou experiência ideal por localização, estilo de vida, orçamento, comodidades ou velocidade de WiFi, e verifique a disponibilidade de quartos para suas datas — e então acesse nomadstays.com para concluir a reserva e o pagamento.
Trusted Stay Partners podem conectar seu próprio assistente de IA (veja Configurando Seu Assistente de IA como Trusted Stay Partner abaixo) para que ele possa consultar e atualizar seus anúncios de Stay, quartos, pacotes de preços, dados organizacionais, perfil comercial e fotos em seu nome. Veja as seções 🔐 Ferramentas de Consulta com Escopo do Proprietário e ✏️ Ferramentas de Escrita com Escopo do Proprietário abaixo.
👥 Nômades & Stay Partners
O que cada tipo de usuário pode fazer
🤖 Protocolo MCP
Use com assistentes de IA como Claude
💡 Exemplos
Veja exemplos de solicitações e respostas
🆘 Central de Ajuda
Acesse artigos de ajuda e suporte por meio das ferramentas MCP
📊 Modelo de Dados
Entenda a estrutura do objeto de estadia
🏨 Integração com Fornecedores
Envie sua disponibilidade para o Nomad Stays em tempo real
👥 O Que Você Pode Fazer
Este servidor MCP atende a dois tipos de usuários. Escolha a coluna que corresponde a você:
🧳 Nômades Digitais & Trabalhadores Remotos
Qualquer pessoa que procura um lugar para ficar e trabalhar.
- Crie uma conta no Nomad Stays diretamente na conversa
- Pesquise estadias por país, continente, cidade, estilo de vida, orçamento, comodidades ou velocidade de WiFi
- Verifique a disponibilidade de quartos para datas específicas ou encontre as datas disponíveis mais próximas
- Obtenha um orçamento de preço em tempo real para um pacote de estadia, depois reserve e receba um link de checkout hospedado para pagar
- Verifique o status de pagamento de uma reserva pelo PNR
- Liste todas as suas próprias reservas passadas e futuras
- Pesquise na Central de Ajuda por respostas ou navegue pelas categorias de ajuda
🏡 Trusted Stay Partners
Qualquer pessoa que anuncia ou deseja anunciar uma propriedade no Nomad Stays.
- Inicie, salve e envie uma nova solicitação de Stay, Experience ou Coworking
- Pague a taxa de inscrição e verifique o status do pagamento
- Liste seus próprios Stays e verifique a pontuação de conclusão do anúncio de cada um
- Visualize e atualize detalhes do Stay, quartos, pacotes de preços e dados organizacionais
- Gerencie fotos do Stay e dos quartos — envie, exclua e reordene
- Visualize e atualize seu perfil comercial
- Consulte dados de referência (tipos de quarto, instalações, moedas, políticas de cancelamento etc.) necessários para preencher os itens acima
As ferramentas de Trusted Stay Partner exigem conectar um assistente de IA com um login no Nomad Stays — veja Configurando Seu Assistente de IA como Trusted Stay Partner abaixo.
🤖 Model Context Protocol (MCP)
Este servidor implementa a especificação MCP, permitindo que assistentes de IA descubram e usem dados de estadias naturalmente na conversa. Agora inclui ferramentas da Central de Ajuda para pesquisar e recuperar artigos de suporte diretamente via MCP.
🚀 Configuração Rápida para o Claude Desktop
Conecte este servidor ao Claude Desktop em poucos cliques — sem necessidade de editar arquivos de configuração:
Passo 1: No Claude Desktop, vá em Configurações → Conectores e clique em Adicionar conector personalizado.
Passo 2: Insira a URL do servidor:
https://mcp.nomadstays.com/mcp
O Claude Desktop abrirá um prompt de login — entre com sua conta do Nomad Stays e clique em Permitir. Você pode então perguntar: "Encontre estadias para trabalho remoto em Portugal"
Para Usuários do Claude.ai e ChatGPT Web
- Vá em Configurações → Conectores (Claude.ai) ou nas configurações equivalentes de conector/MCP no ChatGPT
- Clique em "Adicionar conector personalizado" / "Adicionar servidor"
- Insira a URL do servidor:
https://mcp.nomadstays.com/mcp - Conclua o prompt de login do Nomad Stays e clique em Permitir, e então comece a usar nas conversas!
POST / MCP Protocol
Endpoint do protocolo MCP para integração com assistentes de IA.
Integração
Para usar este servidor com Claude ou outros assistentes compatíveis com MCP, configure seu cliente MCP com:
{ "mcpServers": { "nomadstays": { "url": "https://mcp.nomadstays.com/mcp" } } }
🔑 Configurando Seu Assistente de IA como Trusted Stay Partner (Passo a Passo)
Se você gerencia um Stay no Nomad Stays, pode deixar seu próprio assistente de IA ler e atualizar seu anúncio, quartos, preços e fotos por você. Você não precisa saber programar — é uma conexão de autoatendimento usando seu login do Nomad Stays, sem esperar pela equipe do Nomad Stays. Isso funciona com ChatGPT, Claude.ai e Conectores do Claude Desktop.
Passo 1 — Ative a autenticação de dois fatores
Antes de conectar um agente, sua conta no Nomad Stays precisa ter a autenticação de dois fatores (2FA) ativada. Isso protege seu anúncio caso o acesso seja perdido ou compartilhado. Acesse Ativar autenticação de dois fatores e siga as instruções na tela se ainda não tiver feito isso.
Passo 2 — Adicione o conector no seu assistente de IA
No ChatGPT ou Claude.ai, adicione um novo conector/servidor MCP apontando para https://mcp.nomadstays.com/mcp. No Claude Desktop, adicione-o em Configurações → Conectores em vez disso. Seu assistente abrirá um prompt de login e autorização do Nomad Stays — entre e clique em Permitir. O acesso é concedido imediatamente, e você pode revisar ou revogar agentes conectados a qualquer momento na sua página de Informações do Operador.
Passo 3 — Experimente
Inicie uma nova conversa e pergunte algo como: "Liste meus Stays" ou "Mostre os pacotes de preços atuais do meu Stay." Se seu assistente responder com seus dados reais do anúncio, está funcionando.
Dúvidas? Fale conosco.
Ferramentas Disponíveis
| Nome da Ferramenta | Descrição | Parâmetros |
|---|---|---|
| 🆘 Ferramentas da Central de Ajuda | ||
searchHelpCenter | Pesquisar artigos de ajuda por palavra-chave ou pergunta | query (string), category (string opcional), limit (número opcional) |
getHelpCenterArticle | Recuperar um artigo de ajuda específico por ID | id (string) |
listHelpCenterCategories | Listar todas as categorias disponíveis da central de ajuda | Nenhum |
| 🔍 Ferramentas de Pesquisa e Filtro | ||
getStaysByCountry | Pesquisar estadias por código de país de 2 letras ou nome parcial do país | countrycode (string), limit (número) |
getStaysByContinent | Filtrar estadias por continente (Europa, Ásia, África, etc.) | continent (string), limit (número) |
getStaysByLocation | Pesquisar em Cidade, Estado, nome do local, país e descrição | location (string), limit (número) |
getStaysByLifestyle | Encontrar estadias por categoria de estilo de vida | lifestyle (string), limit (número) |
getStaysByBudget | Pesquisar estadias dentro do orçamento e duração com conversão de câmbio | durationDays, maxPrice, currency, countryCode (opcional), checkInDate (opcional), limit (opcional) |
getStaysByAmenities | Pesquisar estadias por comodidades com correspondência difusa | amenities (array), matchType (opcional), minWifiSpeed (opcional), limit (opcional) |
getStaysByWiFiSpeed | Encontrar todas as estadias com velocidade de download de WiFi superior a 10Mbps. | minWiFiDownloadSpeed (número), limit (número) |
getStayByID | Obter informações detalhadas sobre uma estadia específica | id (número) |
| 👤 Ferramentas de Conta | ||
signupNomadStaysAccount | Criar uma nova conta Nomad Stays para alguém que ainda não possui uma. A conta permanece inativa até a pessoa clicar no link de confirmação enviado por e-mail — nenhuma sessão ou token é retornado | firstName, lastName, email, telephone, password, acceptGdpr |
| 📅 Ferramentas de Disponibilidade e Reserva | ||
checkStayAvailability | Verificar disponibilidade de quartos para datas específicas | stayId, checkIn, checkOut, roomType (opcional) |
findNearestAvailability | Encontrar as datas disponíveis mais próximas do check-in preferido | stayId, preferredCheckIn, minLengthOfStay, maxLengthOfStay (opcional), searchWindowDays (opcional) |
getAvailabilityByMonth | Obter calendário de disponibilidade para um mês específico | stayId, year, month, minLengthOfStay |
getRoomAvailability | Verificar disponibilidade para um quarto específico | roomId, checkIn, checkOut |
| 🧳 Ferramentas de Reserva de Estadias (exigem um token de agente MCP com o escopo "bookings") | ||
quoteStayBooking | Obter um orçamento de preço e disponibilidade calculado pelo servidor para reservar um pacote de estadia em nome do próprio solicitante. O preço é sempre recalculado a partir dos níveis de preço reais do pacote. Retorna um quoteId válido por cerca de 15 minutos | packageId, checkIn, checkOut, rooms (opcional), adults (opcional), children (opcional), pets (opcional) |
bookStay | Criar uma reserva real a partir de um quoteId retornado por quoteStayBooking e retornar uma checkoutUrl hospedada. O membro deve abrir a checkoutUrl por conta própria para pagar — nenhum dado de cartão passa pelo assistente | quoteId, contactName (opcional), contactEmail (opcional), contactPhone (opcional), specialRequest (opcional) |
getBookingStatus | Verificar o status real de pagamento de uma reserva de estadia pelo PNR. O status é sempre reverificado diretamente contra a Airwallex se ainda não estiver confirmado como pago | pnr |
listMyBookings | Listar todas as reservas de estadias pertencentes à conta do próprio solicitante, das mais recentes para as mais antigas. Cada reserva inclui needsAction: true se ainda não foi paga, com uma checkoutUrl pronta para uso | Nenhum |
| 📚 Ferramentas de Referência e Metadados | ||
getAllLifestyles | Recuperar todas as categorias de estilo de vida disponíveis | Nenhum |
getAllAmenities | Recuperar todas as comodidades disponíveis no sistema | Nenhum |
getRoomAmenities | Obter comodidades para um quarto específico | roomId |
| 🔐 Ferramentas de Consulta com Escopo do Proprietário (exigem um token de agente MCP) | ||
getMyStays | Listar todas as estadias pertencentes à conta vinculada ao token de agente MCP | Nenhum |
getMyStayDetail | Obter o título atual, a descrição e o status de listagem de uma estadia | stayId |
getMyStayOnboardingStatus | Obter as seis pontuações de "Conclusão da Listagem" da estadia (Detalhes da Estadias, Disponibilidade, Quartos, Pacotes, Wi-Fi, Informações do Operador) além de uma porcentagem geral de conclusão. Wi-Fi é uma pontuação de frescor do teste, não uma classificação de velocidade; Informações do Operador é um rótulo de status ("Aberto"), não uma porcentagem real | stayId |
getMyStayRooms | Listar todos os quartos configurados em uma estadia | stayId |
getMyStayPackages | Listar todos os pacotes de preços e níveis de preço em uma estadia | stayId |
getMyStayOrganisationalData | Obter o endereço, a política de check-in/check-out e a política de cancelamento de uma estadia | stayId |
getMyStayContacts | Obter os dados de contato públicos de uma estadia | stayId |
getMyStayFacilities | Obter as caixas de seleção de instalações de uma estadia para um determinado grupo de instalações | stayId, group |
getMyStayPhotos | Listar as fotos de uma estadia por área (listagem, principal, espaço de trabalho, anfitrião) | stayId |
getMyBusinessProfile | Obter o perfil comercial da conta Trusted Stay Partner (nome legal, números de IVA/registro) | Nenhum |
getRoomTypeOptions | Listar tipos de quarto válidos para uma estadia — estadias boutique obtêm apenas Boutique1–Boutique6, estadias padrão obtêm tipos de quarto comuns | stayId |
getRoomFacilityOptions | Listar todas as opções de instalações em nível de quarto | Nenhum |
getCurrencyOptions | Listar moedas válidas para preços de pacotes | Nenhum |
getBusinessModelOptions | Listar valores válidos para o modelo de negócios de uma estadia — somente leitura (não editável via MCP ou pela própria interface do painel de estadias), mas o valor que ele contém determina a fórmula do sellPrice e se advertisingEndpoint se aplica a packages | None |
getFacilityGroups | Lista todos os grupos de instalações nos quais as instalações de uma estadia são organizadas | None |
getStayTypeOptions | Lista valores válidos para o tipo principal de acomodação de uma estadia | None |
getCountryOptions | Lista países válidos, com nomes e códigos de 2 letras | None |
getCancellationPolicyOptions | Lista valores válidos de política de cancelamento | None |
getAdditionalInformationOptions | Lista valores válidos para um campo de lista de seleção (ex.: Animais de Estimação Permitidos, Crianças Permitidas, Estacionamento) usado em dados organizacionais | filterName |
| ✏️ Ferramentas de Escrita com Escopo do Proprietário (exigem um token de agente MCP) | ||
updateStayDetail | Atualiza o título e/ou a descrição de uma estadia | stayId, title (opcional), description (opcional) |
createStayRoom | Cria um novo quarto em uma estadia | stayId, roomTitle, roomDescription (opcional), beds (opcional), maxPerson (opcional) e mais |
updateStayRoom | Atualiza um quarto existente em uma estadia | stayId, roomId, além de quaisquer campos do quarto a alterar |
deleteStayRoom | Exclusão lógica (soft-delete) de um quarto de uma estadia | stayId, roomId |
createStayPackage | Cria um novo pacote de preços em uma estadia, opcionalmente com faixas de preço iniciais | stayId, packageName, prices (matriz opcional) e mais |
updateStayPackage | Atualiza um pacote de preços. Fornecer prices substitui TODAS as linhas de preço desse pacote | stayId, packageId, além de quaisquer campos de pacote/preço a alterar |
deleteStayPackage | Exclui permanentemente um pacote de preços e todas as suas faixas de preço (exclusão definitiva, ao contrário dos quartos) | stayId, packageId |
updateStayOrganisationalData | Atualiza o endereço de uma estadia, política de check-in/check-out, animais de estimação/crianças/estacionamento, política de cancelamento | stayId, além de quaisquer campos organizacionais a alterar |
updateStayContacts | Atualiza os dados de contato públicos de uma estadia | stayId, além de quaisquer campos de contato a alterar |
updateStayFacilities | Define a lista completa de caixas de seleção de instalações selecionadas para um grupo de instalações em uma estadia. Qualquer item não incluído é desmarcado | stayId, group, facilityDetailIds (lista completa de substituição) |
updateHostBusinessProfile | Atualiza o perfil comercial da conta Trusted Stay Partner. Nunca altera dados pessoais, bancários ou de identificação fiscal | businessName, vatNumber, businessNumber, entityAccount — todos opcionais |
uploadStayPhoto | Envia uma foto para o anúncio de uma estadia, área principal, de trabalho, do anfitrião ou do quarto. Forneça uma URL pública https:// ou bytes codificados em base64. Cada foto é validada quanto ao formato JPEG/PNG/WebP, tamanho (até 20MB), resolução mínima (1920×1080 paisagem, ou 1080×1350 retrato para a área "host"), e é reduzida para caber em 2560×1440 e re-codificada como WebP no servidor antes do armazenamento | stayId, area, url ou base64, roomId (obrigatório quando area é "room") |
deleteStayPhoto | Exclui uma foto de nível de estadia por área e nome de arquivo | stayId, area, fileName |
reorderStayPhotos | Reordena as fotos de uma estadia dentro de uma determinada área | stayId, area, fileNames (lista ordenada completa) |
deleteRoomPhoto | Exclui uma foto de nível de quarto por área e nome de arquivo | stayId, roomId, roomArea, fileName |
reorderRoomPhotos | Reordena as fotos de um quarto dentro de uma determinada área | stayId, roomId, roomArea, fileNames (lista ordenada completa) |
| 💳 Ferramentas de Pagamento de Produtos (exigem um token de agente MCP) | ||
getProductInfo | Consulta o preço e a disponibilidade de compra de um produto — produto 8 (Inscrição de Estadias) ou produto 9 (Inscrição de Experiências), ambos EUR 39 | productId |
purchaseProduct | Inicia uma compra em nome do próprio chamador. Retorna uma checkoutUrl que o membro deve abrir e pagar por conta própria, ou resolve imediatamente como "waived" se o chamador já se qualificar para uma isenção de taxa | productId (8 para Inscrição de Estadias, 9 para Inscrição de Experiências), applicationId (opcional — correlaciona o pagamento à inscrição) |
getPurchaseStatus | Verifica se uma compra foi paga — só reporta "paid" após uma nova verificação no servidor junto ao provedor de pagamento | saleId |
| 📋 Ferramentas de Inscrição de Estadias (exigem um token de agente MCP) | ||
listStayApplications | Lista as Inscrições de Estadias do chamador (rascunho e enviadas), cada uma com uma dica de nextAction | None |
getStayApplication | Obtém o estado atual completo de uma Inscrição de Estadias, incluindo nextAction e (se incompleta) missingFields | applicationId |
createStayApplication | Inicia uma nova Inscrição de Estadias. Quaisquer campos podem ser fornecidos agora ou preenchidos depois via saveStayApplication | Todos os campos opcionais — veja os campos de candidato, endereço, estadia e propriedade abaixo |
saveStayApplication | Atualiza qualquer subconjunto de campos em uma inscrição existente ainda não enviada | applicationId, além de quaisquer campos de createStayApplication a alterar |
submitStayApplication | Envia uma inscrição concluída para revisão humana. Rejeita com missingFields se incompleta, ou com 409 se a Taxa de Inscrição (produto 8) ainda não foi paga/isenta | applicationId |
| 🧭 Ferramentas de Inscrição de Experiências (exigem um token de agente MCP) | ||
listExperienceApplications | Lista as Inscrições de Experiências do chamador (rascunho e enviadas), cada uma com uma dica de nextAction | None |
getExperienceApplication | Obtém o estado atual completo de uma Inscrição de Experiências, incluindo nextAction e (se incompleta) missingFields | applicationId |
createExperienceApplication | Inicia uma nova Inscrição de Experiências. Experiências devem ter duração mínima de 4 dias (aplicado no servidor) | Todos os campos opcionais — veja os campos de candidato, endereço e detalhes da experiência |
saveExperienceApplication | Atualiza qualquer subconjunto de campos em uma inscrição existente ainda não enviada | applicationId, além de quaisquer campos de createExperienceApplication a alterar |
submitExperienceApplication | Envia uma inscrição concluída para revisão humana. Rejeita com missingFields se incompleta, ou com 409 se a Taxa de Inscrição (produto 9, NÃO o produto 8) ainda não foi paga/isenta | applicationId |
| 🏢 Ferramentas de Inscrição de Coworking (exigem um token de agente MCP) | ||
listCoworkingApplications | Lista as Inscrições de Coworking do chamador (rascunho e enviadas), cada uma com uma dica de nextAction hint | None |
getCoworkingApplication | Obtenha o estado completo e atual de uma Candidatura de Coworking, incluindo nextAction e (se incompleta) missingFields | applicationId |
createCoworkingApplication | Inicie uma nova Candidatura de Coworking. Muito mais simples que Stay/Experience: sem regras de IVA/turismo/modelo de negócio e sem Taxa de Inscrição — nextAction vai direto para submit assim que coworkingName, applicantName, applicantEmail, city e country estiverem presentes | Todos os campos são opcionais — coworkingName, applicantName, applicantEmail, telephone, address, city, country, website |
saveCoworkingApplication | Atualize qualquer subconjunto de campos em uma candidatura existente que ainda não foi enviada | applicationId, além de qualquer um dos campos de createCoworkingApplication a serem alterados |
submitCoworkingApplication | Envie uma candidatura concluída para revisão humana. Rejeita com missingFields se estiver incompleta. Não há Taxa de Inscrição para Coworking, então isso nunca retorna uma resposta de pagamento obrigatório | applicationId |
📊 Modelo de Dados
Objeto Stay
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador único da estadia |
name | string | Nome do alojamento |
description | string | Breve descrição da estadia |
country | string | Nome completo do país |
countryCode | string | Código de país ISO 3166-1 alpha-2 |
city | string | Nome da cidade |
priceRange | string | Faixa de preço semanal (ex.: "A partir de EUR 250 por semana") |
priceCurrency | string | Código da moeda (ex.: EUR, USD) |
amenities | array | Lista de comodidades disponíveis |
WiFiDownloadSpeed | number | Velocidade de download do WiFi em Mbps (opcional) |
WiFiUploadSpeed | number | Velocidade de upload do WiFi em Mbps (opcional) |
location_name | string | Nome do local da tabela Location |
location_country | string | País do local da tabela Location |
PetsAllowed | boolean | Se animais de estimação são permitidos |
coordinates | object | Coordenadas GeoLat e GeoLng |
bookingUrl | string | URL para reservar a estadia |
Comodidades Comuns
Identificadores padrão de comodidades usados na API:
high_speed_wifi- Conexão de internet de alta velocidadededicated_desk- Espaço de trabalho dedicadokitchen- Acesso à cozinha completacoworking_space- Espaço de coworking no localgym- Instalações de fitnesspool- Piscinaparking- Estacionamento disponívelpet_friendly- Animais de estimação permitidos
💡 Exemplos de Uso
Encontrar estadias em Portugal
curl "https://mcp.nomadstays.com/api/stays?countrycode=PT&limit=10"
Pesquisar na Central de Ajuda por perguntas sobre WiFi
# Usando a ferramenta MCP: searchHelpCenter # Exemplo: Encontrar artigos de ajuda sobre WiFi { "tool": "searchHelpCenter", "parameters": { "query": "WiFi" } }
Encontrar estadias na Europa
# Usando a ferramenta MCP: getStaysByContinent # Pesquisa por nome do continente
Encontrar estadias em Paris ou perto de praias
# Usando a ferramenta MCP: getStaysByLocation # Pesquisa em cidade, estado, nome do local e descrições
Obter todas as estadias (sem filtro)
curl "https://mcp.nomadstays.com/api/stays?limit=50"
Obter detalhes de uma estadia específica
curl "https://mcp.nomadstays.com/api/stays/stay\_001"
Usando com Claude (MCP)
Após a configuração, basta perguntar naturalmente ao Claude:
"Você pode me ajudar a encontrar acomodações para trabalho remoto na Tailândia?"
"Mostre-me estadias em Paris com bom WiFi"
"Quero ficar perto de uma praia na Europa"
🆘 Integração com a Central de Ajuda
O servidor MCP agora fornece acesso direto à Central de Ajuda do Nomad Stays. Você pode pesquisar artigos de ajuda, recuperar artigos específicos por ID e listar categorias disponíveis usando as novas ferramentas MCP. Isso permite que assistentes de IA e usuários obtenham suporte e respostas para perguntas comuns de forma programática.
- Use
searchHelpCenterpara encontrar artigos por palavra-chave ou pergunta. - Use
getHelpCenterArticlepara buscar um artigo específico pelo seu ID. - Use
listHelpCenterCategoriespara navegar pelos tópicos de ajuda disponíveis.
Para navegação manual, visite a Central de Ajuda do Nomad Stays.
🌍 Países Suportados
Códigos de país atualmente disponíveis (exemplos):
PT - Portugal
ES - Espanha
TH - Tailândia
MX - México
CO - Colômbia
ID - Indonésia
GR - Grécia
IT - Itália
Nota: Use a API para descobrir a lista completa de países disponíveis.
🏨 Integração com Fornecedor / PMS
Se você opera um sistema de gerenciamento de propriedades (PMS) ou um channel manager, pode sincronizar seu calendário de disponibilidade diretamente com o Nomad Stays. Dois modos de integração estão disponíveis:
Opção 1 — Servidor MCP (Pull)
Execute seu próprio servidor MCP que expõe uma ferramenta get_allocation. O Nomad Stays o consulta a cada hora e grava a disponibilidade retornada em nosso sistema de reservas automaticamente.
- Exponha seu servidor via HTTPS (Streamable HTTP
POST /mcppreferido) - Implemente a ferramenta
get_allocation— recebeproperty_id,start_date,end_date - Retorne um array
rangesapenas com períodos de datas com alocação reduzida - Proteja com um token Bearer — o Nomad Stays envia
Authorization: Bearer <key>em cada requisição
Opção 2 — Webhook Push (Recomendado)
Envie alterações de disponibilidade para o Nomad Stays no momento em que ocorrerem — sem esperar pelo próximo ciclo de polling. Quando o webhook push está habilitado, o Nomad Stays reduz o polling para uma verificação de segurança diária.
POST /api/mcp/availability-push/{stayId} Base: https://www.nomadstays.com
Autenticação
Assine cada requisição com HMAC-SHA256 usando o segredo compartilhado que o Nomad Stays fornece durante a integração:
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 }
]
}
Inclua apenas intervalos de datas onde a disponibilidade está reduzida em relação ao normal. Envie "ranges": [] para limpar todos os bloqueios.
Códigos de Resposta
| Status | Significado |
|---|---|
200 OK | Aceito — {"received": true, "reductions": N} |
401 | Assinatura ausente ou incorreta |
404 | Estadia ou quarto não encontrado |
Para a especificação completa da integração, incluindo exemplos de código em Python e Node.js, entre em contato conosco para iniciar a integração.
⚡ Limites de Taxa e Boas Práticas
- Limite de taxa: 100 requisições por minuto por IP
- Use parâmetros de limite apropriados para evitar busca excessiva
- Armazene respostas em cache quando possível para reduzir chamadas à API
- Sempre verifique o endpoint de saúde antes de fazer requisições em massa
🆘 Suporte
Para perguntas, problemas ou solicitações de recursos:
- Contato: Página de Contato
Servidor MCP do Nomad Stays v0.7.0 | Feito para nômades digitais e trabalhadores remotos 🌎