OpenSEO
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
Elige la app de IA que usas y copia la configuración.
Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.nomadstays.com) · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude · unos 2 min
Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
CustomizeConnectors
Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue
Nomad Stayshttps://mcp.nomadstays.com/mcpPulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add
+ConnectorsNomad Stays
Usa Nomad Stays y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Nomad Stays o muestra una herramienta de Nomad Stays en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con ChatGPT según tu plan
MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web
Plugins+Add custom MCP server
Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin
Nomad Stayshttps://mcp.nomadstays.com/mcpAbre un chat nuevo y elige Nomad Stays en tus plugins antes de escribir
Usa Nomad Stays y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si ChatGPT dice que está usando Nomad Stays o muestra una herramienta de Nomad Stays en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Claude Code · unos 2 min
Sin clave y sin instalar nada
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --transport http --scope user nomadstays https://mcp.nomadstays.com/mcpDeberías ver Nomad Stays en la lista como conectado
Usa Nomad Stays y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Nomad Stays o muestra una herramienta de Nomad Stays en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor · unos 2 min
Sin clave y sin instalar nada
Usa Nomad Stays y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Nomad Stays o muestra una herramienta de Nomad Stays en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code · unos 2 min
Sin clave y sin instalar nada
Usa Nomad Stays y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Nomad Stays o muestra una herramienta de Nomad Stays en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
Dirección para apps que se conectan por la web
https://mcp.nomadstays.com/mcpLa configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --transport http --scope user nomadstays https://mcp.nomadstays.com/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"nomadstays": {
"url": "https://mcp.nomadstays.com/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"nomadstays": {
"type": "http",
"url": "https://mcp.nomadstays.com/mcp"
}
}
}Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se conectan por internet en
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Nombres y descripciones de las herramientas tal como los informó el servidor el 11 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.
getStayByIDReturns full details for a single stay. The id parameter searches both EntryId and StayId fields.
signupNomadStaysAccountCreates a new NomadStays account on behalf of a person who does not have one yet. No authentication required — this is how an AI agent gets a person started. The account is created but inactive until the person clicks the confirmation link sent to their email; this call returns n
getStaysByCountryReturns stays from the NomadStays database. Search by 2-letter country code (e.g., 'MA', 'US') or country name (e.g., 'Antigua' matches 'Antigua and Barbuda')
getStaysByContinentReturns stays from the NomadStays database filtered by continent. Search by continent name (e.g., 'Europe', 'Asia', 'Africa', 'North America', 'South America', 'Oceania')
getStaysByLocationReturns stays from the NomadStays database that match a location search term. Searches across City, State, location_name, location_country, and location_description fields. Use this for flexible location searches (e.g., 'Paris', 'California', 'Beach', 'Mountain')
searchHelpCenterSearch NomadStays Help Center articles from the public knowledgebase endpoint and return matching title/content/slug entries.
getHelpCenterArticleFetch a specific NomadStays Help Center article by its ID. Returns the full article content, title, slug, and categories.
listHelpCenterCategoriesList all available NomadStays Help Center categories. Returns category ID, name, slug, description, and article count for each category.
getStaysByLifestyleReturns stays from the NomadStays database filtered by lifestyle/genre category (e.g., 'Digital Nomad', 'Beach Life', 'City Living', 'Mountain Retreat'). Each stay can belong to multiple lifestyle categories.
getStaysByBudgetSearch for stays that fit within a budget for a given duration. Country is OPTIONAL - can search globally or filter by specific country. Perfect for queries like 'Find me somewhere to stay for 1 month under EUR 1000' or 'Find me a place in Spain for 1 month under EUR 1000'.
getStaysByAmenitiesFind all stays that have specific amenities. Searches both stay-level amenities (referenced by tbStayFacilities) and room-level amenities (referenced by tbRoomFacilities). Use matchType 'any' to find stays with at least one amenity, or 'all' to find stays with all requested ameni
getStaysByWiFiSpeedFind all stays with WiFi download speed greater than 10Mbps, listed and not suspended.
getAllLifestylesReturns all active lifestyle/genre categories available in NomadStays. Use this to discover what lifestyle categories exist before searching with getStaysByLifestyle.
getStayCountsByCountryReturns how many stays NomadStays has in each country, most first. Each row has the country name, 2-letter code, continent, 'stays' (live public listings) and 'bookableNow' (those currently listed for booking). Use this for questions like 'which countries have the most stays', 'h
getAllAmenitiesList all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.RoomFacilityFk).
checkStayAvailabilityCheck if a specific stay is available for given check-in and check-out dates. Returns availability status and room details.
hasAvailabilityInWindowEfficiently checks whether a stay has ANY open booking window of a minimum length within a date range, without checking every single day. Use this to filter search results down to stays with real availability somewhere in the near future (e.g. 'available at all in the next 6 mont
findNearestAvailabilityFind the nearest available dates when requested dates are not available. Searches for alternative check-in dates within a specified window and can adjust length of stay.
getAvailabilityByMonthGet all available booking windows in a specific month that meet the minimum length of stay requirement. Returns all possible check-in dates and their corresponding available periods.
getRoomAvailabilityCheck a specific room's availability for each night in a date range. Returns availability status (available/not available) for each night.
getRoomAmenitiesGet comprehensive list of all facilities and amenities for a specific room, including WiFi metrics (download/upload speed, jitter). Returns room details, all facilities, and network performance data.
getMyStaysList all Stays owned by the account bound to the MCP agent token. Returns stayId, title, and listed status for each — use this to find a stayId before calling any other owner-scoped tool. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getMyStayDetailGet the current title, description, and listed status for one of your Stays. Call this before updateStayDetail so the agent knows the current values and doesn't accidentally overwrite them. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getMyStayOnboardingStatusGet the Stay's listing-completion scores — the same six 'Listing Completion' cards shown on the Stay dashboard (Stay Details, Availability, Rooms, Packages, Wi-Fi, Operator Information), plus an overall completion percentage. Use this when a host asks how far along they are with
getMyStayRoomsList all rooms currently configured on one of your Stays, including bed setup, occupancy, facilities (resolved to names, not just IDs), and every room/workspace photo as a viewable CDN URL. Call this before createStayRoom, updateStayRoom, deleteStayRoom, deleteRoomPhoto, or reord
getMyStayPackagesList all pricing packages on one of your Stays, including their full price tiers (days, buy price, sell price, comparison price, listed status). Call this before createStayPackage or updateStayPackage — hosts often forget exactly what packages/pricing they've already set. Require
getMyStayOrganisationalDataGet a Stay's organisational data: address, check-in/out policy, pets/children/parking, cancellation policy, tourism/land-registration numbers. Call this before updateStayOrganisationalData so the agent knows current values. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getMyBusinessProfileGet the host account's business profile: legal business name, VAT/business registration numbers, whether registered as a business entity. Does NOT include bank or tax-ID details — those are never exposed via MCP. Call this before updateHostBusinessProfile. Requires NOMADSTAYS_MCP
updateStayDetailUpdate a Stay's title and/or description. Requires an MCP agent token (NOMADSTAYS_MCP_AGENT_TOKEN) scoped to the owning account. Only fields supplied are changed.
createStayRoomCreate a new room on a Stay. Call getRoomTypeOptions(stayId) and getRoomFacilityOptions() first to find valid roomTypeFK/roomFacilityFk values. Boutique Stays are capped at 6 rooms total (one per Boutique1-6 slot) — creation is rejected once all 6 exist. Requires an MCP agent tok
updateStayRoomUpdate an existing room on a Stay. Only fields supplied are changed. Call getRoomTypeOptions(stayId) and getRoomFacilityOptions() first to find valid roomTypeFK/roomFacilityFk values. Requires an MCP agent token scoped to the owning account.
getStaySupplierConnectionFor Stay Partners whose own system holds availability and bookings (a connected supplier): show a Stay's connection to the partner's MCP server — the server URL, whether an API key is set (never the key itself), whether the Stay is priced by the day, the last sync time and error,
updateStaySupplierConnectionConnect a Stay to the partner's own MCP server, change the connection, or disconnect it (empty mcpServerUrl). The server must implement get_allocation, check_availability, create_booking and cancel_booking (Nomad Stays connected supplier spec) and be public https. Set each room's
listMyStayBookingsList the bookings on one of your Stays (from 30 days ago by default), with dates, rooms, guests, your price and the supplier status (pending_push, pending, confirmed, refused, cancelled…) and your supplier reference, so your system can reconcile with Nomad Stays. Never shows the
confirmStayBookingAs a connected supplier, confirm a booking on one of your Stays that your system accepted as pending (confirmed: true with your supplierReference), or refuse it (confirmed: false with a reason). Confirm within 30 minutes of the booking or the Nomad Stays team is alerted. A refusa
deleteStayRoomDelete (soft-delete) a room from a Stay. Requires an MCP agent token scoped to the owning account.
getRoomTypeOptionsList valid room types for a specific Stay's rooms (roomTypeFK in createStayRoom/updateStayRoom). Valid values depend on the Stay: boutique Stays choose from a fixed boutique type range; standard Stays are restricted to types already used on one of their own rooms. Requires NOMADS
getRoomFacilityOptionsList every room-level amenity/facility option available (roomFacilityFk in createStayRoom/updateStayRoom) — e.g. Wi-Fi, Air Conditioning, Private Bathroom. Wi-Fi is mandatory and always included even if not explicitly selected. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
deleteRoomPhotoDelete one photo from a room's gallery. Call getMyStayRooms first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
reorderRoomPhotosChange the display order of a room's photo gallery. fileNames must be the FULL current gallery (same set, just reordered) — call getMyStayRooms first. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
createStayPackageCreate a new pricing package on a Stay, optionally with initial price tiers. Requires an MCP agent token scoped to the owning account.
updateStayPackageUpdate an existing pricing package on a Stay. Supplying 'prices' replaces ALL price rows for that package. Requires an MCP agent token scoped to the owning account.
deleteStayPackagePermanently delete a pricing package and all its price tiers from a Stay. This is a hard delete (unlike room deletion, which is soft). Requires an MCP agent token scoped to the owning account.
getCurrencyOptionsList valid currency ids/codes for use as a package's currencyFK.
updateStayOrganisationalDataUpdate a Stay's organisational data: address, check-in/out policy, pets/children/parking, cancellation policy, accommodation type, tourism/land-registration numbers, 'Why Choose Us' reasons, and more. Only fields supplied are changed. IMPORTANT: countryId, petsAllowedId, children
updateHostBusinessProfileUpdate the host account's business profile (legal business name, VAT/business registration numbers). Applies to the account owning the MCP agent token, not a specific stay. Only fields supplied are changed. Does NOT touch bank or tax-ID details — those are not MCP-writable.
uploadStayPhotoUpload a photo to one of your Stay's photo areas. Supply EXACTLY ONE of 'url' (a public https:// link, e.g. a Google Drive or Dropbox share link — the server downloads it) or 'base64' (the raw image bytes, base64-encoded — use this when you already have the image data in hand, e.
getMyStayContactsGet a Stay's contact/owner/manager details and social media links: owner name/email/mobile, manager (day-to-day contact person) name/email/mobile, booking email/phone/mobile, host display name, and website/Facebook/Twitter/YouTube/Instagram/TikTok/LinkedIn links. Call this before
updateStayContactsUpdate a Stay's contact/owner/manager details and social media links. Only fields supplied are changed. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getMyStayFacilitiesGet the available options AND current selections for one facility/checkbox group on a Stay — e.g. 'Languages Spoken' returns every language the platform supports plus which ones are currently selected for this Stay. Call getFacilityGroups first if you don't know the exact group n
updateStayFacilitiesSet which options are selected for one facility/checkbox group on a Stay — e.g. which languages are spoken. facilityDetailIds is the COMPLETE replacement list: anything not included will be UNCHECKED. Call getMyStayFacilities first to see current selections and valid IDs before c
getFacilityGroupsList every facility/checkbox group name that exists on the platform (e.g. 'Languages Spoken', 'General', 'Services', 'Meal', 'Position', 'Remote Worker'). Call this first if you don't already know the exact group name to pass to getMyStayFacilities/updateStayFacilities. Requires
getStayTypeOptionsList valid values for a Stay's 'Main Accommodation Type' (stayTypeId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getCountryOptionsList valid values for a Stay's country (countryId in updateStayOrganisationalData), with each country's name and 2-letter code. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getCancellationPolicyOptionsList valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getAdditionalInformationOptionsList valid values for one of the Additional Information picklists used in updateStayOrganisationalData: Children Allowed, Pets Allowed, or Parking. These are NOT booleans — they're lookup IDs (e.g. 'Yes', 'No', 'On Request') — call this to find the right value before writing pets
getBusinessModelOptionsList valid values for a Stay's listing/business model (businessModelId, read-only — displayed on the Stay but not editable via MCP or the host UI itself). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
getMyStayPhotosGet every current photo for a Stay across all areas (listing gallery, main/hero, workspace/coworking gallery, host), each as a full https:// CDN URL an agent can view directly (not just a filename). Call this before deleteStayPhoto or reorderStayPhotos to see current filenames. R
deleteStayPhotoDelete one photo from a Stay. Call getMyStayPhotos first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
reorderStayPhotosChange the display order of a Stay's listing or workspace photo gallery. fileNames must be the FULL current gallery (same set of files, just reordered) — call getMyStayPhotos first. This only reorders; it cannot add or remove photos. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 16 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub nomadstays, dueña del repo
Último cambio de código: hace 4 días
Usa BSD-3-Clause
No hace falta iniciar sesión
Leímos 60 descripciones de herramientas y no encontramos instrucciones ocultas para la IA
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.
El repo de GitHub cambió por última vez hace 4 días, y la última versión (0.7.0) llegó al registro hace 4 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).
En la misma categoría: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
An MCP (Model Context Protocol) server that gives AI agents access to Nomad Stays accommodation data — search by country, continent, location, lifestyle, budget, amenities, and availability.
Compatible with Claude, ChatGPT, and any MCP-aware AI agent.
Full, current tool list: 78 tools total. See mcp.nomadstays.com for the complete reference with parameters — this README lists them grouped by category; keep both in sync when tools are added or changed.
| Tool | Description |
|---|---|
getStaysByCountry | Search stays by 2-letter country code or country name |
getStaysByContinent | Search by continent (Europe, Asia, Africa, etc.) |
getStaysByLocation | Free-text search across city, region, location description |
getStaysByLifestyle | Filter by lifestyle category (Digital Nomad, Beach, City…) |
getStaysByBudget | Find stays within a budget for a given duration and currency |
getStaysByAmenities | Filter by amenities (WiFi, Pool, Air Conditioning…) |
getStaysByWiFiSpeed | Filter by minimum WiFi download speed (Mbps) |
getStayByID | Full details for a single stay |
getStayCountsByCountry | Number of stays per country, most first (optional continent filter) |
getAllLifestyles | List all available lifestyle categories |
getAllAmenities | List all available amenities |
checkStayAvailability | Check if a stay is available for given dates |
findNearestAvailability | Find nearest available dates when preferred dates are taken |
getAvailabilityByMonth | All available windows in a specific month |
getRoomAvailability | Per-room availability for a date range |
getRoomAmenities | Full amenity list for a specific room including WiFi metrics |
searchHelpCenter | Search Nomad Stays help centre articles |
getHelpCenterArticle | Fetch a specific help article by ID |
listHelpCenterCategories | List all help centre categories |
If the person you're assisting doesn't have a Nomad Stays account yet, use the signupNomadStaysAccount tool to create one for them — no authentication, browser, or CAPTCHA required.
| Tool | Description |
|---|---|
signupNomadStaysAccount | Create a new Nomad Stays account for someone who doesn't have one yet. Returns pending_email_confirmation — no session or token. |
Notes:
Controllers/AgentSignupApiController.cs in the main repo).www.nomadstays.com/Account/Login, they can request an MCP bearer token or complete OAuth (see "Trusted Stay Partner management tools" below) to let their own agent act on their behalf going forward.Stay, Experience, and Coworking applications each go through the same list / get / create / save / submit lifecycle. Stay and Experience applications carry a one-time EUR 39 Application Fee (products 8 and 9); Coworking applications have no fee.
| Tool | Description |
|---|---|
getProductInfo | Look up a product's price and purchasability (product 8 = Stay Application, 9 = Experience Application) |
purchaseProduct | Start a purchase on the caller's own behalf; returns a checkoutUrl or resolves as "waived" |
getPurchaseStatus | Check whether a purchase has been paid, verified fresh against the payment provider |
listStayApplications / getStayApplication / createStayApplication / saveStayApplication / submitStayApplication | Full Stay Application lifecycle |
listExperienceApplications / getExperienceApplication / createExperienceApplication / saveExperienceApplication / submitExperienceApplication | Full Experience Application lifecycle (min. 4-day experiences, enforced server-side) |
listCoworkingApplications / getCoworkingApplication / createCoworkingApplication / saveCoworkingApplication / submitCoworkingApplication | Full Coworking Application lifecycle — no Application Fee |
| Tool | Description |
|---|---|
quoteStayBooking | Price a prospective booking (package, dates, guests) before committing |
bookStay | Create a booking on the caller's own behalf; returns a checkoutUrl or resolves as confirmed |
getBookingStatus | Check whether a booking is confirmed, verified fresh against the payment provider |
listMyBookings | List the caller's own bookings, including needsAction/checkoutUrl for anything still pending |
getCancellationOptions | Whether the caller's own paid booking can still be cancelled under the Stay's policy, the deadline and what they'd get back |
cancelBooking | Cancel the caller's own paid booking (requires confirm: true); refund/credit to the member's wallet, Custom policy sends a request only |
createStayEnquiry | Enquire about a Stay that can't be booked right now; the Nomad Stays team replies to the member by email |
The tools above are read-only and public (aside from applications, which are self-service but still token-gated). A separate set of tools lets an authorized Trusted Stay Partner's own AI agent read AND write their own listing data — with the same capabilities (no more, no less) as they have via the Nomad Stays admin UI. These require a bearer token issued from the partner's Operator Information page at www.nomadstays.com/stayadmin/user-profile-stays (2FA must be enabled on the account to request one), set as NOMADSTAYS_MCP_AGENT_TOKEN. Every call is scoped server-side to Stays the authenticated account actually owns.
| Tool | Description |
|---|---|
getMyStays / getMyStayDetail / updateStayDetail | Read/update a Stay's core details (title, description, address, policies) |
getMyStayOnboardingStatus | The six "Listing Completion" scores from the Stay dashboard (Stay Details, Availability, Rooms, Packages, Wi-Fi, Operator Information) plus an overall percentage — Wi-Fi is a test-freshness score, not a speed rating |
getMyStayRooms / createStayRoom / updateStayRoom / deleteStayRoom | Full room CRUD, including bed sizes, facilities, and photos |
getStaySupplierConnection / updateStaySupplierConnection | Connect a Stay to the partner's own MCP server (connected supplier): URL, API key, priced by the day |
listMyStayBookings | Bookings on one of your Stays with their supplier status, for reconciling with your own system |
confirmStayBooking | Confirm a pending booking with your reference, or refuse it with a reason |
getRoomTypeOptions / getRoomFacilityOptions | Reference lookups for valid room types/facilities (differ for boutique vs standard Stays) |
uploadStayPhoto / getMyStayPhotos / deleteStayPhoto / reorderStayPhotos | Stay-level photo management, including reordering |
deleteRoomPhoto / reorderRoomPhotos | Room-level photo management |
getMyStayPackages / createStayPackage / updateStayPackage / deleteStayPackage | Pricing package CRUD — sellPrice is always server-computed, never directly settable |
getCurrencyOptions / getBusinessModelOptions | Reference lookups for package currency and business model |
getMyStayOrganisationalData / updateStayOrganisationalData | Address, check-in/out policy, cancellation policy, pets/children/parking rules |
getStayTypeOptions / getCountryOptions / getCancellationPolicyOptions / getAdditionalInformationOptions | Reference lookups for organisational-data fields |
getMyStayContacts / updateStayContacts | Public-facing contact details |
getMyStayFacilities / updateStayFacilities / getFacilityGroups | Facility checkboxes, grouped exactly as on the admin UI |
getMyBusinessProfile / updateHostBusinessProfile | Business profile (excludes personal, bank, and tax fields — never exposed via MCP) |
Key rules: boutique Stays (Boutique1–Boutique6 room types) and standard Stays are validated separately — always call getRoomTypeOptions first. Package price tiers are locked to 7/14/21/30 nights and don't all need to be set — a subset (e.g. 1-week-only) is valid. advertisingEndpoint only applies to Advertising-business-model Stays. Personal, bank, and tax details are permanently excluded from every tool.
git clone https://github.com/nomadstays/nomadstays-mcp-server.git
cd nomadstays-mcp-server npm install
cp .env.example .env
npm run build
node build/index.js
PORT=8080 node build/index.js
HTTP endpoints:
POST /mcp — MCP Streamable HTTP transportGET /health — Health checkGET /api/mcp/stats/daily — Daily usage statsGET /api/mcp/stats/tools — Per-tool usage statsCopy claude_desktop_config.example.json, update the path and connection string, then merge into your claude_desktop_config.json:
{
"mcpServers": { "nomadstays": { "command": "node", "args": ["/path/to/nomadstays-mcp-server/build/index.js"], "env": { "NOMADSTAYS_DB_CONNECTION": "Server=tcp:..." } } } }
The production Nomad Stays deployment runs its MCP servers as Docker containers on Coolify (self-hosted on Hetzner) rather than Azure App Service. This repo doesn't include a Dockerfile of its own — containerize it with a standard Node.js build (Node 20+, npm run build, run dist/index.js) and deploy to any Docker-capable host, setting NOMADSTAYS_DB_CONNECTION (and PORT/HTTP_PORT for HTTP mode) as environment variables on the target platform.