Skip to main content
Glama

Server Details

Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
nomadstays/nomadstays-mcp-server
GitHub Stars
0
Server Listing
Nomad Stays
ChatGPT
–
Claude
–

TDQS

A3.6/5.0

Scored across 86 tools

Disambiguation3/5

The set spans four distinct personas (member booking, host listing management, applications, help center) and most tools are clearly scoped to one. However, there are dense overlapping clusters: eight search tools (getStaysByCountry/Continent/Location/Amenities/Budget/Lifestyle/WiFiSpeed plus getStayByID), four availability tools (checkStayAvailability, getAvailabilityByMonth, findNearestAvailability, hasAvailabilityInWindow), and getMyStays vs getStayByID vs getStayCountsByCountry all compete for 'find a stay' selection. Descriptions disambiguate reasonably well, but there is real risk of the agent picking the wrong search or availability tool.

Naming Consistency4/5

All names are camelCase with a leading verb, and there is a discernible family pattern: getMyStay* for host-owned resources, getXByY for catalog searches, and create/save/submit/get/list for applications. Deviations are minor but present — 'hasAvailabilityInWindow' and 'emailMeShortlist' break the verb_noun shape, 'getStayByID' uses a different ID capitalization, and getMyStayDetail (singular) sits next to getMyStays.

Tool Count2/5

86 tools is far beyond what an agent can hold cleanly in scope, and the surface is effectively five products stitched together (member bookings, host listing CRUD, three application workflows, search, help center). While each family is internally coherent, this should be split into separate servers or name-spaced, and it approaches the 'extreme mismatch' band.

Completeness4/5

Lifecycle coverage is genuinely strong: quote → book → status → cancel for members, full detail/rooms/packages/photos/facilities/contacts/org-data/supplier editing for hosts, and complete create/save/submit/list/get flows for all three application types. Gaps are moderate rather than blocking — no tool to delete or create a Stay, no management of Experiences beyond their application, and no reviews or member-profile operations.

Available Tools

86 tools
bookStayAInspect

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.

Inputs: quoteId (required), contactName, contactEmail, contactPhone, +1 more.

cancelBookingA
Destructive
Inspect

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.

Inputs: pnr (required), confirm (required), reason.

checkStayAvailabilityB
Read-only
Inspect

Check if a specific stay is available for given check-in and check-out dates. Returns availability status and room details.

Inputs: stayId (required), checkIn (required), checkOut (required), roomType.

confirmStayBookingA
Idempotent
Inspect

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.

Inputs: pnr (required), confirmed (required), reason, supplierReference.

createCoworkingApplicationAInspect

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.

Inputs: city, address, country, website, +4 more.

createExperienceApplicationAInspect

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.

Inputs: zip, city, state, maxPax, +24 more.

createStayApplicationAInspect

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.

Inputs: zip, city, state, mobile, +20 more.

createStayEnquiryAInspect

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.

Inputs: stayId (required), message (required), nights, arrivalDate.

createStayPackageAInspect

Create a new pricing package on a Stay, optionally with initial price tiers. Requires an MCP agent token scoped to the owning account.

Inputs: stayId (required), currencyFK (required), packageName (required), listed, +8 more.

createStayRoomAInspect

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.

Inputs: stayId (required), roomTitle (required), beds, maxPerson, +6 more.

deleteRoomPhotoA
Destructive
Inspect

Delete one photo from a room's gallery. Call getMyStayRooms first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: roomId (required), stayId (required), fileName (required), roomArea (required).

deleteStayPackageA
Destructive
Inspect

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.

Inputs: stayId (required), packageId (required).

deleteStayPhotoA
Destructive
Inspect

Delete one photo from a Stay. Call getMyStayPhotos first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: area (required), stayId (required), fileName (required).

deleteStayRoomA
Destructive
Inspect

Delete (soft-delete) a room from a Stay. Requires an MCP agent token scoped to the owning account.

Inputs: roomId (required), stayId (required).

emailMeShortlistAInspect

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.

Inputs: email (required), stayIds (required), userConsented (required).

findNearestAvailabilityA
Read-only
Inspect

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.

Inputs: stayId (required), minLengthOfStay (required), preferredCheckIn (required), maxLengthOfStay, +1 more.

getAdditionalInformationOptionsA
Read-only
Inspect

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.

Inputs: filterName (required).

getAllAmenitiesA
Read-only
Inspect

List all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.RoomFacilityFk).

Inputs: no named parameters.

getAllLifestylesA
Read-only
Inspect

Returns all active lifestyle/genre categories available in NomadStays. Use this to discover what lifestyle categories exist before searching with getStaysByLifestyle.

Inputs: no named parameters.

getAvailabilityByMonthB
Read-only
Inspect

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.

Inputs: year (required), month (required), stayId (required), minLengthOfStay (required).

getBookingStatusA
Read-only
Inspect

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.

Inputs: pnr (required).

getBusinessModelOptionsA
Read-only
Inspect

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.

Inputs: no named parameters.

getCancellationOptionsA
Read-only
Inspect

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.

Inputs: pnr (required).

getCancellationPolicyOptionsA
Read-only
Inspect

List valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: no named parameters.

getCountryOptionsA
Read-only
Inspect

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.

Inputs: no named parameters.

getCoworkingApplicationA
Read-only
Inspect

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.

Inputs: applicationId (required).

getCurrencyOptionsA
Read-only
Inspect

List valid currency ids/codes for use as a package's currencyFK.

Inputs: no named parameters.

getExperienceApplicationA
Read-only
Inspect

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.

Inputs: applicationId (required).

getFacilityGroupsA
Read-only
Inspect

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.

Inputs: no named parameters.

getHelpCenterArticleA
Read-only
Inspect

Fetch a specific NomadStays Help Center article by its ID. Returns the full article content, title, slug, and categories.

Inputs: id (required).

getMyBusinessProfileA
Read-only
Inspect

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.

Inputs: no named parameters.

getMyStayContactsA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayDetailA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayFacilitiesA
Read-only
Inspect

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.

Inputs: group (required), stayId (required).

getMyStayOnboardingStatusA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayOrganisationalDataA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayPackagesA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayPhotosA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStayRoomsA
Read-only
Inspect

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.

Inputs: stayId (required).

getMyStaysA
Read-only
Inspect

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.

Inputs: no named parameters.

getProductInfoA
Read-only
Inspect

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.

Inputs: productId (required).

getPurchaseStatusA
Read-only
Inspect

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.

Inputs: saleId (required).

getRoomAmenitiesA
Read-only
Inspect

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.

Inputs: roomId (required).

getRoomAvailabilityA
Read-only
Inspect

Check a specific room's availability for each night in a date range. Returns availability status (available/not available) for each night.

Inputs: roomId (required), checkIn (required), checkOut (required).

getRoomFacilityOptionsA
Read-only
Inspect

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.

Inputs: no named parameters.

getRoomTypeOptionsA
Read-only
Inspect

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.

Inputs: stayId (required).

getStayApplicationA
Read-only
Inspect

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.

Inputs: applicationId (required).

getStayByIDB
Read-only
Inspect

Returns full details for a single stay. The id parameter searches both EntryId and StayId fields.

Inputs: id (required).

getStayCountsByCountryA
Read-only
Inspect

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.

Inputs: continent.

getStaysByAmenitiesA
Read-only
Inspect

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.

Inputs: amenities (required), limit, matchType, minWifiSpeed.

getStaysByBudgetA
Read-only
Inspect

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 under EUR 1000' or 'Find me a place in Spain for 1 month under EUR 1000'.

Inputs: currency (required), maxPrice (required), durationDays (required), limit, +3 more.

getStaysByContinentB
Read-only
Inspect

Returns stays from the NomadStays database filtered by continent. Search by continent name (e.g., 'Europe', 'Asia', 'Africa', 'North America', 'South America', 'Oceania')

Inputs: continent (required), limit.

getStaysByCountryB
Read-only
Inspect

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')

Inputs: countrycode (required), limit.

getStaysByLifestyleB
Read-only
Inspect

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 categories.

Inputs: lifestyle (required), limit.

getStaysByLocationA
Read-only
Inspect

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 location searches (e.g., 'Paris', 'California', 'Beach', 'Mountain')

Inputs: location (required), limit.

getStaysByWiFiSpeedA
Read-only
Inspect

Find all stays with WiFi download speed greater than 10Mbps, listed and not suspended.

Inputs: limit, minWiFiDownloadSpeed.

getStaySupplierConnectionA
Read-only
Inspect

For 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, and each room's mcpRoomId. Nomad Stays calls the partner's get_allocation, check_availability, create_booking and cancel_booking tools. Requires an MCP agent token scoped to the owning account.

Inputs: stayId (required).

getStayTypeOptionsA
Read-only
Inspect

List valid values for a Stay's 'Main Accommodation Type' (stayTypeId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: no named parameters.

hasAvailabilityInWindowA
Read-only
Inspect

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 availability somewhere in the near future (e.g. 'available at all in the next 6 months for a month-long stay'), instead of calling checkStayAvailability repeatedly for individual dates.

Inputs: stayId (required), fromDate (required), minLengthOfStay (required), windowDays.

listCoworkingApplicationsA
Read-only
Inspect

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 unlike Stay/Experience there is no pay_application_fee step. Call this to find an in-progress application's applicationId before resuming it. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: no named parameters.

listExperienceApplicationsA
Read-only
Inspect

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, submit, awaiting_review, or accepted). Call this to find an in-progress application's applicationId before resuming it. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: no named parameters.

listHelpCenterCategoriesA
Read-only
Inspect

List all available NomadStays Help Center categories. Returns category ID, name, slug, description, and article count for each category.

Inputs: no named parameters.

listMyBookingsA
Read-only
Inspect

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 checkoutUrl — call this proactively (e.g. at the start of a session, or when the member asks what's pending) and surface any needsAction bookings to the member, since there is no other way for them to be notified of an incomplete booking through this connection. Requires NOMADSTAYS_MCP_AGENT_TOKEN with the 'bookings' scope.

Inputs: no named parameters.

listMyStayBookingsA
Read-only
Inspect

List 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 booking fee the client paid Nomad Stays. Requires an MCP agent token scoped to the owning account.

Inputs: stayId (required), from.

listStayApplicationsA
Read-only
Inspect

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, awaiting_review, or accepted). Call this to find an in-progress application's applicationId before resuming it. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: no named parameters.

purchaseProductAInspect

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 payment step and returns status 'waived'. Otherwise it returns a checkoutUrl hosted on nomadstays.com — you must hand this URL to the member and ask them to open it in their own browser and pay; you cannot complete payment on their behalf. Poll getPurchaseStatus with the returned saleId afterwards to find out when it's actually paid. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: productId (required), applicationId.

quoteStayBookingAInspect

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 price shown elsewhere. Picks the largest price tier whose length is <= the requested nights (e.g. 10 nights against 7/14/21/30-day tiers uses the 7-day tier's rate), falling back to the smallest tier if the stay is shorter than all of them. Returns a quoteId valid for about 15 minutes — call bookStay with it to actually create the booking and get a payment link. Requires the caller's token to carry the 'bookings' OAuth scope (McpMember role), separate from the listings-management 'McpAgent' scope other tools here use.

Inputs: checkIn (required), checkOut (required), packageId (required), pets, +3 more.

reorderRoomPhotosAInspect

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.

Inputs: roomId (required), stayId (required), roomArea (required), fileNames (required).

reorderStayPhotosAInspect

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; it cannot add or remove photos. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: area (required), stayId (required), fileNames (required).

saveCoworkingApplicationAInspect

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 with a 409 if the application has already been submitted. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required), city, address, country, +5 more.

saveExperienceApplicationAInspect

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 with a 409 if the application has already been submitted. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required), zip, city, state, +25 more.

saveStayApplicationAInspect

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 the application has already been submitted. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required), zip, city, state, +21 more.

searchHelpCenterB
Read-only
Inspect

Search NomadStays Help Center articles from the public knowledgebase endpoint and return matching title/content/slug entries.

Inputs: limit, query.

signupNomadStaysAccountAInspect

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 the person clicks the confirmation link sent to their email; this call returns no session or token, so the agent cannot sign in or act as the user itself. Once confirmed, the person can log in at nomadstays.com/Account/Login and request their own MCP bearer token or OAuth grant to let an agent manage their account/listings going forward.

Inputs: email (required), lastName (required), password (required), firstName (required), +2 more.

submitCoworkingApplicationAInspect

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 submitStayApplication/submitExperienceApplication — this never returns a pay_application_fee/409-unpaid response. On success the application moves to human review. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required).

submitExperienceApplicationAInspect

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 purchaseProduct with productId 9 and applicationId first — Experience uses product 9, NOT product 8). There is no partial/optimistic submission. On success the application moves to human review. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required).

submitStayApplicationAInspect

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 purchaseProduct with productId 8 and applicationId first). There is no partial/optimistic submission — everything required must already be in place. On success the application moves to human review; nothing further is needed from the agent. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: applicationId (required).

updateHostBusinessProfileAInspect

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 changed. Does NOT touch bank or tax-ID details — those are not MCP-writable.

Inputs: vatNumber, businessName, entityAccount, businessNumber.

updateStayContactsBInspect

Update a Stay's contact/owner/manager details and social media links. Only fields supplied are changed. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: stayId (required), tikTok, twitter, website, +14 more.

updateStayDetailAInspect

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. Fails with a 409 if the Stay is Closed (check status with getMyStays first); the same applies to every other tool that edits a Stay, its rooms, packages, photos, contacts, facilities or supplier connection.

Inputs: stayId (required), title, description.

updateStayFacilitiesAInspect

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. Call getMyStayFacilities first to see current selections and valid IDs before changing them. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: group (required), stayId (required), facilityDetailIds (required).

updateStayOrganisationalDataAInspect

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. Only fields supplied are changed. IMPORTANT: countryId, petsAllowedId, childrenAllowedId, parkingId, cxPolicyId, and stayTypeId are lookup IDs, NOT plain text or booleans — call getCountryOptions / getAdditionalInformationOptions / getCancellationPolicyOptions / getStayTypeOptions first to find the correct ID to send. Requires an MCP agent token scoped to the owning account.

Inputs: stayId (required), city, state, geoLat, +26 more.

updateStayPackageBInspect

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.

Inputs: stayId (required), packageId (required), listed, maxPax, +10 more.

updateStayRoomAInspect

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 agent token scoped to the owning account.

Inputs: roomId (required), stayId (required), beds, maxPerson, +7 more.

updateStaySupplierConnectionAInspect

Connect 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 mcpRoomId with updateStayRoom. Only fields supplied are changed. Requires an MCP agent token scoped to the owning account.

Inputs: stayId (required), mcpApiKey, pricesByDay, mcpServerUrl.

uploadStayPhotoAInspect

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 bytes, base64-encoded — use this when you already have the image data in hand, e.g. a user attached a photo in the conversation, and have nowhere public to host it first). The photo is validated against the same minimum specs as a manual upload: JPEG, PNG, or WebP, under 20MB, and a minimum resolution that depends on area. Most areas require at least 1920x1080 landscape; 'host' requires at least 1080x1350 PORTRAIT — a landscape photo will be rejected for that area. Every upload is downscaled to fit within 2560x1440 and re-encoded server-side as WebP (stripping metadata and anything that isn't genuine image data) before storage. Requires NOMADSTAYS_MCP_AGENT_TOKEN.

Inputs: area (required), stayId (required), url, base64, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search remote job listings, read full descriptions and structured metadata, compare roles, and retrieve original application links when the account's subscription and scopes allow.
      31
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to search and explore remote job listings, salary stats, and popular roles, and supports token-authenticated actions like job alerts and apply redirects.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Search current remote / work-from-home jobs by category, region, perk, or company — with ready-to-apply links.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to search live remote and hybrid job postings and read any listing in full. Supports filtering by keywords, job function, countries, region, workplace type, seniority level, and posting age.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.