Nomad Stays
REMOTE · MCP.NOMADSTAYS.COM
Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
Available components
Last scanned (18 hours ago)
Scores higher than 74% of remote servers
Reachable. Last reached 21 Nov 2026.
Category E-commerce
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security60
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: this server exposes a tool marked destructive (deleteStayRoom) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated. View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability79
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 19811 tokens (~186/item across 106 items; 86 tools + 20 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage88
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 63% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 88 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
- Supports UI / widget rendering.Pass
Checks we ran (13)
- TLS certificate
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
- Capabilities
Checks we could not complete (1)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Authorization in Endpoint SecurityAuthorisation not fully verified: this server exposes a tool marked destructive (deleteStayRoom) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Nov 26 0
- Tool “getMyStayDetail” rewrote its description, which is the text the model reads security
- Tool “getMyStays” rewrote its description, which is the text the model reads security
- Tool “updateStayDetail” rewrote its description, which is the text the model reads security
- Resource “Tisno Adriatic Remote Work Living” was removed ▼ functional
- New resource “Rustic Mountain Homestead in Spain” functional
- 19 Nov 26 0
- “updateStayOrganisationalData” reworded the description of “tourismNumber” cosmetic
1 cosmetic change on this day. Switch on “Show cosmetic changes” to see it.
- 13 Nov 26 0
- New tool “emailMeShortlist” functional
- 12 Nov 26 0
- Stability: fail → pass ▲ security
- 6 Nov 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 4 Nov 26 0
- New tool “confirmStayBooking” functional
- New tool “getStaySupplierConnection” functional
- New tool “listMyStayBookings” functional
- New tool “updateStaySupplierConnection” functional
- 30 Oct 26 0
- New tool “cancelBooking”, which the server declares destructive security
- New tool “getCancellationOptions” functional
- 20 Oct 26 0
- Resource “BeetCommunity” was removed ▼ functional
- Resource “BnB Alcala la Real” was removed ▼ functional
- Resource “Casa do Almance - Pico Island Azores” was removed ▼ functional
- Resource “Invictus Hostel” was removed ▼ functional
- Resource “Serviced Apartment Dallas” was removed ▼ functional
- New resource “Arode Villa Dionysus CoLiving” functional
- New resource “Remote Workers Forest Paradise” functional
- New resource “Single Studio Barcelona” functional
- New resource “Tisno Adriatic Remote Work Living” functional
- New resource “Zilker Townhouse” functional
- New tool “createStayEnquiry” functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://mcp.nomadstays.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.nomadstays.com | CN=YR1,O=Let's Encrypt,C=US | 26 Sept 2026 | 25 Dec 2026 | RSA 4096 | SHA256-RSA | 5ff8e2f0b3c33b75b193e57ee986bb169fa |
| SANs: mcp.nomadstays.com | ||||||
| CN=YR1,O=Let's Encrypt,C=US (CA) | CN=Root YR,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | RSA 2048 | SHA256-RSA | a20253f15f2691c05dc1ce13b9bcca4e |
| CN=Root YR,O=ISRG,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | RSA 4096 | SHA256-RSA | f24b6d17f9d9ad7cb1c9fea78782699f |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of mcp.nomadstays.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| nomadstays.com. | DS published | 2371 | 13 | Verified |
| mcp.nomadstays.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.nomadstays.com/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.nomadstays.com/mcp | HTTPS enforced | 302 | https://mcp.nomadstays.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
bookStay ~220
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 created — a stale or expired quote will be rejected with a message to call quoteStayBooking again. You MUST send the checkoutUrl to the member and tell them to open it in their own browser to pay — you cannot complete this payment on their behalf, and no card details ever pass through you. Requires NOMADSTAYS_MCP_AGENT_TOKEN with the 'bookings' scope.
| Name | Type | Req | Description |
|---|---|---|---|
| contactEmail | string | – | Contact email for the booking. Defaults to the member's account email if omitted. |
| contactName | string | – | Guest's full name for the booking. Defaults to the member's account name if omitted. |
| contactPhone | string | – | Contact phone number for the booking. |
| quoteId | string | yes | The quoteId returned by quoteStayBooking |
| specialRequest | string | – | Any special request to pass along to the Stay. |
No output schema declared.
No examples provided.
cancelBooking ~221
Cancel one of the caller's own paid Stay bookings under the Stay's cancellation policy. Only call this after getCancellationOptions returned canCancel: true, you have told the member its message and onCancel text, and the member has explicitly said they want to cancel; pass confirm: true. Cancelling can't be undone online. A refund or credit of the booking fee goes to the member's Nomad Stays wallet automatically. For a Custom policy (cancellationType 'request') this only sends a request to the Nomad Stays team and the Stay, and the booking stays active until they reply by email. The member, the Stay and the Nomad Stays team are emailed either way. Requires the 'bookings' scope.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | yes | Must be true, and only once the member has explicitly agreed to cancel |
| pnr | string | yes | The booking reference (PNR) to cancel |
| reason | string | – | The member's reason for cancelling, if they gave one (optional, up to 1000 characters) |
No output schema declared.
No examples provided.
checkStayAvailability ~98
Check if a specific stay is available for given check-in and check-out dates. Returns availability status and room details.
| Name | Type | Req | Description |
|---|---|---|---|
| checkIn | string | yes | Check-in date in ISO format (YYYY-MM-DD) |
| checkOut | string | yes | Check-out date in ISO format (YYYY-MM-DD) |
| roomType | string | – | Optional specific room type to check availability for |
| stayId | string | yes | The unique identifier of the stay |
No output schema declared.
No examples provided.
confirmStayBooking ~176
As 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 refusal is a refused booking under the Stay Partner terms: the room is taken off sale automatically and the client must be relocated to an equal or better room. Requires an MCP agent token scoped to the owning account.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | true to confirm, false to refuse |
| pnr | string | yes | The Nomad Stays booking reference (booking_reference in create_booking) |
| reason | string | – | Why the booking is refused (required when refusing) |
| supplierReference | string | – | Your booking reference (required when confirming) |
No output schema declared.
No examples provided.
createCoworkingApplication ~201
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 coworkingName, applicantName, applicantEmail, city and country are present, nextAction goes straight to 'submit'. Call getCountryOptions first to find a valid country name (must be the exact tbCountry.CountryName, not an ID). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | – |
| applicantEmail | string | – | – |
| applicantName | string | – | – |
| city | string | – | – |
| country | string | – | Exact tbCountry.CountryName (not a country ID) — use getCountryOptions and take the countryName field. Must not be a sanctioned country. |
| coworkingName | string | – | – |
| telephone | string | – | – |
| website | string | – | – |
No output schema declared.
No examples provided.
createExperienceApplication ~535
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 supplied. Call getCountryOptions and getBusinessModelOptions first to resolve experienceCountryId/postalCountryId/businessModelId, since country-specific rules (VAT number, tourism number, permitted business models) are enforced server-side and rejections name the specific field/reason. Experiences must run a minimum of 4 days. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| applicantEmail | string | – | – |
| applicantFirstName | string | – | Overrides the profile default for this application only — does not change the member's profile |
| applicantLastName | string | – | Overrides the profile default for this application only — does not change the member's profile |
| availabilitySupplier | string | – | – |
| businessModelId | number | – | tbBusinessModel.EntryID — use getBusinessModelOptions. If the experience country's bookingModelsRestricted flag is true, only a 'StayDirect'-prefixed model is accepted. |
| businessName | string | – | – |
| city | string | – | – |
| comments | string | – | – |
| daysQty | string | – | Minimum 4 days, enforced server-side |
| description | string | – | – |
| downloadSpeed | string | – | – |
| experienceCountryId | number | – | tbCountry.CountryId for where the experience actually takes place — this is the country the application itself is filed under. Use getCountryOptions to find a value. |
| experienceName | string | – | – |
| hasInsurance | boolean | – | – |
| hasKitchen | boolean | – | – |
| laundryFacilities | string | – | – |
| maxPax | string | – | Maximum participants |
| mobile | string | – | – |
| monthlyPrice | string | – | Price per person (USD) |
| overnightLocationsQty | string | – | – |
| postalCountryId | number | – | tbCountry.CountryId for the applicant's billing/postal address — used only to check whether a VAT number is required, and stored on the member's business profile (not on the application itself). Use… |
| state | string | – | – |
| street | string | – | – |
| tourismNumber | string | – | Required if the experience country's tourismNumberRequired flag is true (see getCountryOptions) |
| vatNumber | string | – | Required if the postal country's vatNumberRequired flag is true (see getCountryOptions) |
| website | string | – | – |
| workFacilities | string | – | – |
| zip | string | – | – |
No output schema declared.
No examples provided.
createStayApplication ~510
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. Call getCountryOptions and getBusinessModelOptions first to resolve stayCountryId/postalCountryId/businessModelId, since country-specific rules (VAT number, tourism number, permitted business models) are enforced server-side and rejections name the specific field/reason. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| applicantEmail | string | – | – |
| applicantFirstName | string | – | Overrides the profile default for this application only — does not change the member's profile |
| applicantLastName | string | – | Overrides the profile default for this application only — does not change the member's profile |
| availabilitySupplier | string | – | – |
| businessModelId | number | – | tbBusinessModel.EntryID — use getBusinessModelOptions. If the stay country's bookingModelsRestricted flag is true, only a 'StayDirect'-prefixed model is accepted. |
| businessName | string | – | – |
| city | string | – | – |
| comments | string | – | – |
| downloadSpeed | string | – | – |
| hasKitchen | boolean | – | – |
| laundryFacilities | string | – | – |
| mobile | string | – | – |
| monthlyPrice | string | – | Indicative monthly wholesale price in US dollars (USD) — the application is always priced in USD. Packages are priced in the owner's chosen currency later, after approval. |
| numberOfRooms | string | – | – |
| postalCountryId | number | – | tbCountry.CountryId for the applicant's billing/postal address — used only to check whether a VAT number is required, and stored on the member's business profile (not on the application itself). Use… |
| state | string | – | – |
| stayCountryId | number | – | tbCountry.CountryId for where the Stay is actually located — this is the country the application itself is filed under. Use getCountryOptions to find a value. |
| stayName | string | – | – |
| street | string | – | – |
| tourismNumber | string | – | Required if the stay country's tourismNumberRequired flag is true (see getCountryOptions) |
| vatNumber | string | – | Required if the postal country's vatNumberRequired flag is true (see getCountryOptions) |
| website | string | – | – |
| workFacilities | string | – | – |
| zip | string | – | – |
No output schema declared.
No examples provided.
createStayEnquiry ~219
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 Stays team, who check availability with the Stay and reply to the member by email (usually within one working day). The member's name and email come from their Nomad Stays account; do not ask for them. Only send an enquiry the member has asked for, and include what they told you (who is travelling, work needs, questions). Use bookStay instead whenever a quote succeeds. Requires the 'bookings' scope.
| Name | Type | Req | Description |
|---|---|---|---|
| arrivalDate | string | – | Preferred arrival date, YYYY-MM-DD (optional) |
| message | string | yes | The member's enquiry, up to 2000 characters |
| nights | number | – | Number of nights, 1-365 (optional) |
| stayId | number | yes | The Stay's ID (EntryId), as returned by the search tools or getStayByID |
No output schema declared.
No examples provided.
createStayPackage ~376
Create a new pricing package on a Stay, optionally with initial price tiers. Requires an MCP agent token scoped to the owning account.
| Name | Type | Req | Description |
|---|---|---|---|
| advertisingEndpoint | string | – | OPTIONAL: only usable on Advertising-business-model Stays — ignored otherwise, matching the host UI which hides this field for all other business models. Check getBusinessModelOptions / the Stay's bu… |
| currencyFK | number | yes | REQUIRED: the currency this package is priced in — an id from getCurrencyOptions. Packages can use any supported currency; ASK the owner which one, never assume USD. All buyPrice values are in this c… |
| description | string | – | OPTIONAL: package description |
| endDate | string | – | OPTIONAL: last check-in date this package is available for |
| listed | boolean | – | OPTIONAL: whether the package is publicly listed |
| maxPax | number | – | OPTIONAL: max occupancy for this package |
| packageName | string | yes | Package name |
| prices | array | – | OPTIONAL: initial price tiers. If supplied, replaces all price rows for the package. Exactly one entry per 7/14/21/30-night tier used. |
| roomTypeFK | number | – | OPTIONAL: room type id this package covers. Call getRoomTypeOptions for valid values. |
| startDate | string | – | OPTIONAL: first check-in date this package is available for |
| stayId | number | yes | The Stay's EntryID |
| stayRoomFK | number | – | STRONGLY RECOMMENDED: the specific room this package covers (tbStaysRoom.EntryID). Call getMyStayRooms to find the right room id first. If omitted, the server guesses a room matching roomTypeFK, whic… |
No output schema declared.
No examples provided.
createStayRoom ~328
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 Boutique1-6 slot) — creation is rejected once all 6 exist. Requires an MCP agent token scoped to the owning account.
| Name | Type | Req | Description |
|---|---|---|---|
| beds | number | – | OPTIONAL: number of beds |
| mainBedSize | string | – | OPTIONAL: main bed size |
| maxPerson | number | – | OPTIONAL: max occupancy |
| mcpRoomId | string | – | OPTIONAL: external MCP room identifier to bind. NOT AVAILABLE for boutique Stays — the host UI has no field for this there, and the API will reject it. |
| otherBedSize | string | – | OPTIONAL: other bed size, or empty for none |
| roomDescription | string | – | OPTIONAL: room description |
| roomFacilityFk | array | – | OPTIONAL: facilityDetailId values from getRoomFacilityOptions() — the full set of amenities this room has. Wi-Fi is added automatically even if omitted. |
| roomTitle | string | yes | Room name/title |
| roomTypeFK | number | – | REQUIRED for non-boutique Stays — a roomTypeId from getRoomTypeOptions(stayId). IGNORED for boutique Stays — the next available Boutique1-6 slot is auto-assigned server-side, matching the host UI (wh… |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
deleteRoomPhoto ~111
Delete one photo from a room's gallery. Call getMyStayRooms first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| fileName | string | yes | The exact file name from getMyStayRooms |
| roomArea | string | yes | 'photos' for the regular room gallery, 'workspace' for the room's coworking gallery |
| roomId | number | yes | The room's EntryID |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
deleteStayPackage ~83
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.
| Name | Type | Req | Description |
|---|---|---|---|
| packageId | number | yes | The package's EntryID (tbStayPackages) to delete |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
deleteStayPhoto ~126
Delete one photo from a Stay. Call getMyStayPhotos first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| area | string | yes | Which photo area the file belongs to (room photos aren't supported by this tool — manage those via updateStayRoom) |
| fileName | string | yes | The exact file name from getMyStayPhotos, e.g. '69bdf22cdb0c43a7be3e825a0a3a2074.jpg' |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
deleteStayRoom ~66
Delete (soft-delete) a room from a Stay. Requires an MCP agent token scoped to the owning account.
| Name | Type | Req | Description |
|---|---|---|---|
| roomId | number | yes | The room's EntryID — use getMyStayRooms to find it |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
emailMeShortlist ~249
Emails the person a one-off shortlist of up to 5 stays they have been looking at, with member prices, and a link to create a free account. Members save around 5% - create an account today while it's free. Use it when the person has no account yet and would like to keep or come back to these stays, or says they'll decide later. ONLY call it after the person has asked for the email to be sent to them and given you their address; set userConsented to true to confirm that. It sends one email per address (repeat requests are ignored), never marketing, and carries an opt-out link. Prices and links are looked up by Nomad Stays, not taken from you. The reply is always the same whether or not an email is sent.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | The person's own email address, given to you by them for this purpose | |
| stayIds | array | yes | Stay ids (EntryId from the stay search tools) for the stays to include, best match first. Maximum 5. |
| userConsented | boolean | yes | Set to true only if the person explicitly asked for this shortlist to be emailed to this address. |
No output schema declared.
No examples provided.
findNearestAvailability ~130
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.
| Name | Type | Req | Description |
|---|---|---|---|
| maxLengthOfStay | number | – | Maximum length of stay in days (optional) |
| minLengthOfStay | number | yes | Minimum length of stay in days |
| preferredCheckIn | string | yes | Preferred check-in date in ISO format (YYYY-MM-DD) |
| searchWindowDays | number | – | Number of days before and after preferred date to search (default: 90) |
| stayId | string | yes | The unique identifier of the stay |
No output schema declared.
No examples provided.
getAdditionalInformationOptions ~109
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. 'Yes', 'No', 'On Request') — call this to find the right value before writing petsAllowedId/childrenAllowedId/parkingId. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| filterName | string | yes | Which picklist to fetch options for |
No output schema declared.
No examples provided.
getAllAmenities ~45
List all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.RoomFacilityFk).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getAllLifestyles ~41
Returns all active lifestyle/genre categories available in NomadStays. Use this to discover what lifestyle categories exist before searching with getStaysByLifestyle.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getAvailabilityByMonth ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| minLengthOfStay | number | yes | Minimum length of stay in days required |
| month | number | yes | Month number (1-12, where 1=January, 12=December) |
| stayId | string | yes | The unique identifier of the stay |
| year | number | yes | Year (e.g., 2026) |
No output schema declared.
No examples provided.
getBookingStatus ~98
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 ever returns bookings owned by the caller's own account. Requires NOMADSTAYS_MCP_AGENT_TOKEN with the 'bookings' scope.
| Name | Type | Req | Description |
|---|---|---|---|
| pnr | string | yes | The booking reference (PNR) returned by bookStay |
No output schema declared.
No examples provided.
getBusinessModelOptions ~53
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getCancellationOptions ~158
Check whether one of the caller's own paid Stay bookings can still be cancelled under the Stay's cancellation policy, and what the member would get back. Returns state (open, request_only, expired, non_refundable, started, cancelled, request_pending), canCancel, cancellationType (refund, credit, request or none), deadlineUtc, message and onCancel (what cancelling would do). Always call this first and tell the member the message and onCancel text before offering cancelBooking. When state is expired, tell the member the cancellation period has expired; do not offer cancelBooking. Requires the 'bookings' scope.
| Name | Type | Req | Description |
|---|---|---|---|
| pnr | string | yes | The booking reference (PNR), as returned by bookStay or listMyBookings |
No output schema declared.
No examples provided.
getCancellationPolicyOptions ~41
List valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getCountryOptions ~48
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getCoworkingApplication ~77
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_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listCoworkingApplications to find it) |
No output schema declared.
No examples provided.
getCurrencyOptions ~24
List valid currency ids/codes for use as a package's currencyFK.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getExperienceApplication ~71
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_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listExperienceApplications to find it) |
No output schema declared.
No examples provided.
getFacilityGroups ~78
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 exact group name to pass to getMyStayFacilities/updateStayFacilities. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getHelpCenterArticle ~60
Fetch a specific NomadStays Help Center article by its ID. Returns the full article content, title, slug, and categories.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The WordPress post ID of the Help Center article (e.g., '123') |
No output schema declared.
No examples provided.
getMyBusinessProfile ~68
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 exposed via MCP. Call this before updateHostBusinessProfile. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getMyStayContacts ~116
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 website/Facebook/Twitter/YouTube/Instagram/TikTok/LinkedIn links. Call this before updateStayContacts so the agent knows current values. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayDetail ~100
Get the current title, description, listed flag and status ('Live', 'Paused' or 'Closed') for one of your Stays. A Closed Stay is read-only and cannot be edited. Call this before updateStayDetail so the agent knows the current values and doesn't accidentally overwrite them. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayFacilities ~154
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 for this Stay. Call getFacilityGroups first if you don't know the exact group name. Common groups: 'General', 'Services', 'Languages Spoken', 'Meal', 'Position', 'Remote Worker'. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| group | string | yes | Exact facility group name, e.g. 'Languages Spoken', 'General', 'Services', 'Meal', 'Position', 'Remote Worker' (call getFacilityGroups for the full list) |
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
getMyStayOnboardingStatus ~206
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 overall completion percentage. Use this when a host asks how far along they are with onboarding or what's left to finish. Note: Wi-Fi is a test-freshness score (recency of the last speed test), not a speed rating. Operator Information is the same score the owner's dashboard shows, with a missingItems list of labels (e.g. 'Date of Birth', 'Banking Details') — those fields are owner-only and never writable via MCP, so relay the list to the owner. Stay Details is recalculated automatically after every MCP edit to details, organisational data, contacts, facilities or photos. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayOrganisationalData ~90
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 agent knows current values. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayPackages ~96
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 — hosts often forget exactly what packages/pricing they've already set. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayPhotos ~103
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). Call this before deleteStayPhoto or reorderStayPhotos to see current filenames. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStayRooms ~122
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 before createStayRoom, updateStayRoom, deleteStayRoom, deleteRoomPhoto, or reorderRoomPhotos so the agent can show current values or find the right roomId/fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
No output schema declared.
No examples provided.
getMyStays ~178
List all Stays owned by the account bound to the MCP agent token. Returns stayId, title, listed and status for each — use this to find a stayId before calling any other owner-scoped tool. status is 'Live', 'Paused' or 'Closed'. Paused: the partner has hidden the Stay and it can't be booked, but it can still be edited and the partner can resume it. Closed: the partner has permanently taken the Stay off Nomad Stays, so it is read-only — every write tool for it fails with a 409 error and no further work should be done on it; tell the partner to contact Nomad Stays if it was closed by mistake. Partners pause or close a Stay themselves in their Stay dashboard (not through this connector). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getProductInfo ~107
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-applying, in which case there's nothing to pay and purchaseProduct will process the waiver automatically. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| productId | number | yes | The product's EntryID — use 8 for the Stay Application fee |
No output schema declared.
No examples provided.
getPurchaseStatus ~86
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 instead. Possible statuses: pending, paid, failed, waived. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| saleId | string | yes | The saleId returned by purchaseProduct |
No output schema declared.
No examples provided.
getRoomAmenities ~66
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.
| Name | Type | Req | Description |
|---|---|---|---|
| roomId | string | yes | The unique identifier of the room (tbStaysRoom.EntryID) |
No output schema declared.
No examples provided.
getRoomAvailability ~92
Check a specific room's availability for each night in a date range. Returns availability status (available/not available) for each night.
| Name | Type | Req | Description |
|---|---|---|---|
| checkIn | string | yes | Check-in date in ISO format (YYYY-MM-DD) |
| checkOut | string | yes | Check-out date in ISO format (YYYY-MM-DD) |
| roomId | string | yes | The unique identifier of the room (tbStaysRoom.EntryID) |
No output schema declared.
No examples provided.
getRoomFacilityOptions ~69
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 if not explicitly selected. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
getRoomTypeOptions ~89
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 are restricted to types already used on one of their own rooms. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
No output schema declared.
No examples provided.
getStayApplication ~71
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_AGENT_TOKEN.
| Name | Type | Req | Description |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listStayApplications to find it) |
No output schema declared.
No examples provided.
getStayByID ~46
Returns full details for a single stay. The id parameter searches both EntryId and StayId fields.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Stay identifier (searches the EntryId field) |
No output schema declared.
No examples provided.
getStayCountsByCountry ~122
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 booking). Use this for questions like 'which countries have the most stays', 'how many stays do you have in Spain' or 'where do you have stays'. Optionally filter by continent.
| Name | Type | Req | Description |
|---|---|---|---|
| continent | string | – | Optional continent name or partial match (e.g., 'Europe', 'Asia') |
No output schema declared.
No examples provided.
getStaysByAmenities ~208
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 stays with at least one amenity, or 'all' to find stays with all requested amenities. Can optionally filter by minimum WiFi download speed.
| Name | Type | Req | Description |
|---|---|---|---|
| amenities | array | yes | Array of amenity names to search for (e.g., ['WiFi', 'Air Conditioning', 'Pool']). Use getAllAmenities to see all available amenities. |
| limit | number | – | Maximum number of results to return (default: 25) |
| matchType | string | – | OPTIONAL: 'any' (default) finds stays with at least one amenity, 'all' finds stays with all amenities |
| minWifiSpeed | number | – | OPTIONAL: Minimum WiFi download speed in Mbps (default: 0). Only returns stays with WiFi speed at or above this threshold. |
No output schema declared.
No examples provided.
How do I install the Nomad Stays MCP server?
Nomad Stays is a hosted endpoint at https://mcp.nomadstays.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.nomadstays.com
claude mcp add --transport http nomadstays-mcp-server 'https://mcp.nomadstays.com/mcp'
What is the Nomad Stays MCP server?
Nomad Stays is an MCP server listed in the public MCP registry as io.github.nomadstays/mcp-server. Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings. This page covers its hosted endpoint (https://mcp.nomadstays.com/mcp).
Is the Nomad Stays MCP server safe to use?
Nomad Stays scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Nomad Stays MCP server expose?
Nomad Stays exposes 86 tools: getStayByID, signupNomadStaysAccount, emailMeShortlist, getStaysByCountry, getStaysByContinent, and 81 more. Their descriptions and schemas cost roughly 13,486 tokens of context every time the server is loaded.
Does the Nomad Stays MCP server require authentication?
No. We connected to Nomad Stays without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Nomad Stays MCP server still maintained?
Nomad Stays is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the Nomad Stays MCP server?
VerifyMCP ran 13 checks on Nomad Stays, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 9 more. One item could not be completed, a gap on our side rather than a finding about Nomad Stays: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.