Nomad Stays
io.github.nomadstays/mcp-serverSearch remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
Watch this dependency
Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.
Inspect evidence and set up a watch Share public evidence report
Score: 100/100
Handshake verified by our own probe.
why this score
Tools · 79
Returns full details for a single stay. The id parameter searches both EntryId and StayId fields.
Creates 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 …
Returns 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')
Returns stays from the NomadStays database filtered by continent. Search by continent name (e.g., 'Europe', 'Asia', 'Africa', 'North America', 'South America', 'Oceania')
Returns 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 locat…
Search NomadStays Help Center articles from the public knowledgebase endpoint and return matching title/content/slug entries.
Fetch a specific NomadStays Help Center article by its ID. Returns the full article content, title, slug, and categories.
List all available NomadStays Help Center categories. Returns category ID, name, slug, description, and article count for each category.
Returns 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 cat…
Search 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…
Find 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 …
Find all stays with WiFi download speed greater than 10Mbps, listed and not suspended.
Returns all active lifestyle/genre categories available in NomadStays. Use this to discover what lifestyle categories exist before searching with getStaysByLifestyle.
Returns 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…
List all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.RoomFacilityFk).
Check if a specific stay is available for given check-in and check-out dates. Returns availability status and room details.
Efficiently 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 avai…
Find 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.
Get 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.
Check a specific room's availability for each night in a date range. Returns availability status (available/not available) for each night.
Get 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.
List 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 NOM…
Get 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 N…
Get 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 overa…
List 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 …
List 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…
Get 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 agen…
Get 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 expo…
Update 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.
Create 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 Bout…
Update 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 …
Delete (soft-delete) a room from a Stay. Requires an MCP agent token scoped to the owning account.
List 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…
List 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 …
Delete one photo from a room's gallery. Call getMyStayRooms first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Change 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.
Create a new pricing package on a Stay, optionally with initial price tiers. Requires an MCP agent token scoped to the owning account.
Update 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.
Permanently 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.
List valid currency ids/codes for use as a package's currencyFK.
Update 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.…
Update 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 ch…
Upload 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 b…
Get 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 we…
Update a Stay's contact/owner/manager details and social media links. Only fields supplied are changed. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Get 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…
Set 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.…
List 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…
List valid values for a Stay's 'Main Accommodation Type' (stayTypeId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
List valid values for a Stay's country (countryId in updateStayOrganisationalData), with each country's name and 2-letter code. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
List valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
List 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. 'Y…
List 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.
Get 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). C…
Delete one photo from a Stay. Call getMyStayPhotos first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Change 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…
Look up a Nomad Stays product's price and purchasability — currently only product 8, the Stay Application fee (EUR 39). Returns isWaivedForCaller: true if the caller is already a Stay Partner re-apply…
Start a purchase of a Nomad Stays product on the caller's own behalf. If the caller already qualifies for a waiver (e.g. an existing Stay Partner re-applying), this resolves immediately with no paymen…
Check whether a purchase has been paid. Only ever reports 'paid' after a fresh server-side check against the payment provider — never trust the member's own claim that they've paid, always poll this i…
List the caller's Stay Applications (draft and submitted), each with a nextAction hint telling you what's needed next (provide_applicant_details, provide_property_details, pay_application_fee, submit,…
Get the full current state of one Stay Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty. Requires NOMADSTAYS_MCP_A…
Start a new Stay Application for the caller. Any fields can be supplied now or filled in later via saveStayApplication — the applicant's name defaults from their Nomad Stays profile if not supplied. C…
Update any subset of fields on an existing, not-yet-submitted Stay Application. Same field set and validation rules as createStayApplication — only pass the fields you're changing. Fails with a 409 if…
Submit a completed Stay Application for human review. Rejects with a missingFields list if any required field is still empty, or a 409 if the Application Fee hasn't been paid/waived yet (call purchase…
List the caller's Experience Applications (draft and submitted), each with a nextAction hint telling you what's needed next (provide_applicant_details, provide_experience_details, pay_application_fee,…
Get the full current state of one Experience Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty. Requires NOMADSTAYS…
Start a new Experience Application for the caller. Any fields can be supplied now or filled in later via saveExperienceApplication — the applicant's name defaults from their Nomad Stays profile if not…
Update any subset of fields on an existing, not-yet-submitted Experience Application. Same field set and validation rules as createExperienceApplication — only pass the fields you're changing. Fails w…
Submit a completed Experience Application for human review. Rejects with a missingFields list if any required field is still empty, or a 409 if the Application Fee hasn't been paid/waived yet (call pu…
Get a server-computed price and availability quote for booking a Stay package on the caller's own behalf. Price is always re-derived from the package's actual pricing tiers — never trust or reuse a pr…
Create a real booking from a quoteId returned by quoteStayBooking, and return a hosted checkoutUrl. The quote's price/availability is re-validated server-side one more time before the booking is creat…
Send an enquiry about a Stay that can't be booked right now — for example quoteStayBooking finds no bookable package, or the Stay page says it isn't bookable online. The enquiry goes to the Nomad Stay…
Check a Stay booking's real payment status by PNR. Status is always freshly re-verified against Airwallex directly if not already confirmed paid — never trust a client-supplied claim of success. Only …
List all Stay bookings owned by the caller's own account, most recent first, with each one's current status. Each booking includes needsAction: true if it's still unpaid, with a ready-to-use checkoutU…
List the caller's Coworking Applications (draft and submitted), each with a nextAction hint (provide_coworking_details, submit, awaiting_review, or accepted). Coworking has no Application Fee, so unli…
Get the full current state of one Coworking Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty. Requires NOMADSTAYS_…
Start a new Coworking Application for the caller. Much simpler than the Stay/Experience applications: no VAT/tourism-number/business-model rules, no Application Fee, and no billing step at all — once …
Update any subset of fields on an existing, not-yet-submitted Coworking Application. Same field set and validation rules as createCoworkingApplication — only pass the fields you're changing. Fails wit…
Submit a completed Coworking Application for human review. Rejects with a missingFields list if any required field is still empty. There is no Application Fee to pay for Coworking, so — unlike submitS…
Resources · 20
Stay results widget markup
ui://widget/stay-results.html
Stay availability widget markup
ui://widget/availability.html
Booking quote/checkout/status widget markup
ui://widget/booking.html
Generic list-of-records widget markup
ui://widget/list-cards.html
Step-by-step briefing for a Stay Partner's AI agent: account, application, approval, building the listing, checking progress, and rules.
guide://onboarding/new-stay
Spacious apartment in the San Benedetto area, ideal for holidays or comfortable business stays. The apartment features 2 spacious bedrooms: - one with a double bed - one with a double bed and a s…
stay:///1331
Welcome to NomadUnion Coliving & Coworking. The first Coliving & Coworking on the French Riviera. For Digital Nomads, Slowmads, Location Independent and anyone working remotely. Our 350m² Villa off…
stay:///960
Work. Breathe. Belong. Enjoy this entire house offering 3 rooms and take upto 5 people. If you crave silence that feels like freedom, views that stretch beyond your laptop screen, and air so fre…
stay:///1235
Moon Village Stay UNO and DOS – Garden Cottages for Remote Workers in Mallorca Located in the authentic village of Sa Pobla, Moon Village Stays offers two peaceful garden cottages designed for digi…
stay:///1271
Want to have a Golden Sunset? Your Remote Work Haven on Brac Island Welcome to Golden Sunset, a perfect retreat for digital nomads seeking comfort, productivity, and island living. Located on, B…
stay:///1201
Encanto Bansko – Your Mountain Retreat for Work and Adventure! Looking for a comfortable place for remote work? Encanto Bansko offers everything you need for a long-term stay. Our cozy studio in th…
stay:///1098
Villa Dar Nur – Where Work Meets Island Energy Looking for a workspace that feels like a retreat? Welcome to Villa Dar Nur, your bright private villa in Corralejo, Fuerteventura — designed for re…
stay:///1233
Spacious and furnished studio apartment for long-term rent. The unit is ideal for single tenants or couples. Fully furnished with bed, wardrobe, and TV Air conditioning Private bathroom with …
stay:///1200
Live and Work by the Sea Tisno is a remote work ready Stay where you enjoy Island life and is a welcoming Mediterranean home created for digital nomads, remote workers, freelancers, entrepreneurs, …
stay:///1323
Welcome to Bencomo Coliving, a home created by two local brothers in the heart of Santa Úrsula, Tenerife North — where the mountains meet the ocean. Our space is designed for remote workers, creative…
stay:///1244
A clean, newly renovated cabin on four private acres of forest near Lake George, New York, designed to be both a quiet work base and an easy launchpad for Adirondack adventures. With fast Starlink int…
stay:///1242
About this space Step into your own private oasis in the heart of Austin’s most sought-after neighborhood, Zilker. This spacious and beautifully designed 4-story townhome offers the perfect blend of …
stay:///984
Tisno Adriatic Remote Work & Living is a comfortable apartment in Tisno, on Croatia’s Dalmatian coast, just 50 metres from the sea. Designed for remote workers, digital nomads and longer stays, the…
stay:///1321
Welcome to Balchik: one of the most popular coastal towns of Bulgaria, located on the scenic shores of the Black Sea. With its warm Mediterranean climate and over 300 sunny days per year, Balchik offe…
stay:///1018
Brand new installations and amenities. Single studio (16m2) featuring elevated bed, desk, ensuite bathroom, fully equipped kitchen, and dining table, ideal for digital nomads to work and have a pri…
stay:///1110
Prompts · 1
Walks your AI agent through listing a new Stay on Nomad Stays: account, application and fee, approval, then building rooms, packages and photos until the listing is ready to go live.
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"nomad_stays": {
"url": "https://mcp.nomadstays.com/mcp",
"transport": "streamable-http"
}
}
}