Nomad Stays
What it does
Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
- Connects 클라우드에서 실행
- Account or key No key needed
- Category 검색 및 AI 기억
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 5/5 통과 · 내가 묻는 내용은 제작자 서버(mcp.nomadstays.com)를 거쳐요
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음 · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지 · Team/Enterprise는 소유자(Owner)가 추가
Claude의 Connectors 페이지 열기
CustomizeConnectors
“+ Add” → “Add custom connector”를 누르고 이 2칸 채우기
여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요
Name · 이름Nomad StaysRemote MCP server URL · 주소https://mcp.nomadstays.com/mcpAuthentication은 Claude가 찾은 그대로 두고 Add를 누르세요
채팅에서 켜기
+ConnectorsNomad Stays
해 보기
Nomad Stays을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Nomad Stays을 쓰고 있다고 하거나 답에 Nomad Stays 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 기업용 요금제에서만 연결돼요
웹의 ChatGPT Business, Enterprise, Edu에서 워크스페이스 관리자나 소유자가 추가해요 · Free, Plus, Pro를 쓰면: 내 ChatGPT 요금제로는 아직 MCP를 직접 연결할 수 없어요
웹 ChatGPT에서 MCP 추가 페이지 열기
Plugins+Add custom MCP server
이름과 주소 입력
이름을 넣고 Connection에 주소를 붙여 넣은 뒤 경고에 체크하고 Create as a plugin을 누르세요
Name · 이름Nomad StaysConnection · 주소https://mcp.nomadstays.com/mcp채팅에서 Nomad Stays 고르기
새 채팅을 열고 입력 전에 플러그인 목록에서 Nomad Stays을 고르세요
해 보기
Nomad Stays을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ ChatGPT가 Nomad Stays을 쓰고 있다고 하거나 답에 Nomad Stays 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 OpenAI 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Claude Code에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --transport http --scope user nomadstays https://mcp.nomadstays.com/mcpClaude Code에서 /mcp 입력
Nomad Stays이 목록에 있고 연결됨으로 보이면 돼요
해 보기
Nomad Stays을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Nomad Stays을 쓰고 있다고 하거나 답에 Nomad Stays 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
Nomad Stays을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Nomad Stays을 쓰고 있다고 하거나 답에 Nomad Stays 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
Nomad Stays을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Nomad Stays을 쓰고 있다고 하거나 답에 Nomad Stays 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요
웹으로 연결하는 앱용 주소
https://mcp.nomadstays.com/mcpJSON 설정은 아래 “개발자용”에 있어요
개발자용: 터미널 명령과 JSON 설정
웹으로 연결
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"
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
인터넷으로 연결하는 앱
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
할 수 있는 일
도구 이름과 설명은 서버가 2026년 11월 11일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.
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.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 12일 점검
토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
검색 및 AI 기억 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 6007개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 6007개 중 24%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 6007개 중 100%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
Nomad Stays, 안전한가요?
해당하는 기본 점검 5개 중 5개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 9일 전 변경됐고, 최신 버전(0.7.0)은 3개월 전 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 지원하는 앱에서도 쓸 수 있어요. 예: ChatGPT Business 이상.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: Context7, Codebase Memory, Ruflo
같은 카테고리의 다른 것
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
NomadStays MCP Server
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.
Tools available
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.
Search, availability, and reference (public, no auth)
| 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 |
Account signup for AI agents
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:
- The account is created but inactive until the human clicks the confirmation link emailed to them — no session or token is returned by this call, and the agent cannot sign in or act as the user itself. This is the trust boundary: it proves a real inbox exists behind the request, standing in for the CAPTCHA/honeypot checks the public browser signup form uses instead.
- Rate-limited to 2 requests per 5 minutes per source IP, server-side (
Controllers/AgentSignupApiController.csin the main repo). - Once the human confirms their email and logs in normally at
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.
Product, purchase, and application tools (require an MCP agent token)
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 |
Booking (require an MCP agent token)
| 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 |
Trusted Stay Partner management tools
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.
Setup
1. Prerequisites
- Node.js 20+
- Access to a Nomad Stays SQL Server database (hosted on Coolify/Hetzner)
2. Install
git clone https://github.com/nomadstays/nomadstays-mcp-server.git
cd nomadstays-mcp-server npm install
3. Configure
cp .env.example .env
Edit .env and set your NOMADSTAYS_DB_CONNECTION string
4. Build
npm run build
5. Run (stdio mode — for Claude Desktop / local MCP clients)
node build/index.js
6. Run (HTTP mode — for hosted / remote deployments)
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 stats
Claude Desktop configuration
Copy 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:..." } } } }
Deploy
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.
Tech stack
- TypeScript + Node.js 20
- @modelcontextprotocol/sdk
- Express (HTTP mode)
- mssql (SQL Server connectivity)