Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Nomad Stays is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http nomad-stays-mcp https://mcp.nomadstays.com/mcp
# 2 — ask your agent for something these tools do
# getStayByID, signupNomadStaysAccount, getStaysByCountry and 75 more
Nomad Stays costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http nomad-stays-mcp https://mcp.nomadstays.com/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
78 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Returns full details for a single stay. The id parameter searches both EntryId and StayId fields.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | Stay identifier (searches the EntryId field) |
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 noma
| Parameter | Type | Required | Notes |
|---|---|---|---|
| firstName | string | yes | The person's first name |
| lastName | string | yes | The person's last name |
| string | yes | A real email address the person controls — the confirmation link is sent here and the account stays inactive until it's clicked | |
| telephone | string | yes | Contact telephone number |
| password | string | yes | Account password, minimum 6 characters |
| acceptGdpr | boolean | yes | Must be true — the person has agreed to NomadStays' GDPR terms |
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')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| countrycode | string | yes | 2-letter country code (e.g., 'MA', 'US') or partial country name (e.g., 'Antigua') |
| limit | number | no | Maximum number of results to return (default: 15) |
Returns stays from the NomadStays database filtered by continent. Search by continent name (e.g., 'Europe', 'Asia', 'Africa', 'North America', 'South America', 'Oceania')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| continent | string | yes | Continent name or partial match (e.g., 'Europe', 'Asia', 'Africa') |
| limit | number | no | Maximum number of results to return (default: 15) |
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')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| location | string | yes | Location search term to match against City, State, location_name, location_country, or location_description (e.g., 'Paris', 'California', 'Beach', 'Mountain') |
| limit | number | no | Maximum number of results to return (default: 15) |
Search NomadStays Help Center articles from the public knowledgebase endpoint and return matching title/content/slug entries.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Search term to match against Help Center knowledgebase articles |
| limit | number | no | Maximum number of results to return (default: 15) |
Fetch a specific NomadStays Help Center article by its ID. Returns the full article content, title, slug, and categories.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | The WordPress post ID of the Help Center article (e.g., '123') |
List all available NomadStays Help Center categories. Returns category ID, name, slug, description, and article count for each category.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| lifestyle | string | yes | Lifestyle/genre category name or partial match (e.g., 'Digital Nomad', 'Beach', 'City'). Use getAllLifestyles tool to see all available categories. |
| limit | number | no | Maximum number of results to return (default: 15) |
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'.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| countryCode | string | no | OPTIONAL: 2-letter country code (e.g., 'ES', 'PT') or country name (e.g., 'Spain'). If omitted, searches all countries globally. |
| continent | string | no | OPTIONAL: Continent name (e.g., 'Europe', 'Asia', 'Africa'). Filters results to stays in countries on this continent. If omitted, searches all continents globally. |
| durationDays | number | yes | Duration of stay in days (e.g., 30 for 1 month, 90 for 3 months) |
| maxPrice | number | yes | Maximum price for the entire duration (e.g., 1000 for EUR 1000) |
| currency | string | yes | Currency code (e.g., 'EUR', 'USD', 'GBP') |
| checkInDate | string | no | OPTIONAL: Check-in date. Can be a full date (e.g., '2026-05-15'), a month name (e.g., 'May' ? uses May 1st), or omit for today (2026-01-19) |
| limit | number | no | Maximum number of results to return (default: 15) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| amenities | array | yes | Array of amenity names to search for (e.g., ['WiFi', 'Air Conditioning', 'Pool']). Use getAllAmenities to see all available amenities. |
| matchType | string | no | OPTIONAL: 'any' (default) finds stays with at least one amenity, 'all' finds stays with all amenities |
| minWifiSpeed | number | no | OPTIONAL: Minimum WiFi download speed in Mbps (default: 0). Only returns stays with WiFi speed at or above this threshold. |
| limit | number | no | Maximum number of results to return (default: 25) |
Find all stays with WiFi download speed greater than 10Mbps, listed and not suspended.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| minWiFiDownloadSpeed | number | no | Minimum WiFi download speed in Mbps (default: 10) |
| limit | number | no | Maximum number of results to return (default: 15) |
Returns all active lifestyle/genre categories available in NomadStays. Use this to discover what lifestyle categories exist before searching with getStaysByLifestyle.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| continent | string | no | Optional continent name or partial match (e.g., 'Europe', 'Asia') |
List all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.RoomFacilityFk).
No parameter schema on file.
Check if a specific stay is available for given check-in and check-out dates. Returns availability status and room details.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | string | yes | The unique identifier of the stay |
| 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 | no | Optional specific room type to check availability for |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | string | yes | The unique identifier of the stay |
| fromDate | string | yes | Start of the search window, ISO format (YYYY-MM-DD). Usually today's date. |
| windowDays | number | no | How many days forward from fromDate to search (default: 180, i.e. 6 months) |
| minLengthOfStay | number | yes | Minimum length of stay in days required (e.g. 30 for a month-long stay) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | string | yes | The unique identifier of the stay |
| preferredCheckIn | string | yes | Preferred check-in date in ISO format (YYYY-MM-DD) |
| minLengthOfStay | number | yes | Minimum length of stay in days |
| maxLengthOfStay | number | no | Maximum length of stay in days (optional) |
| searchWindowDays | number | no | Number of days before and after preferred date to search (default: 90) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | string | yes | The unique identifier of the stay |
| year | number | yes | Year (e.g., 2026) |
| month | number | yes | Month number (1-12, where 1=January, 12=December) |
| minLengthOfStay | number | yes | Minimum length of stay in days required |
Check a specific room's availability for each night in a date range. Returns availability status (available/not available) for each night.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomId | string | yes | The unique identifier of the room (tbStaysRoom.EntryID) |
| checkIn | string | yes | Check-in date in ISO format (YYYY-MM-DD) |
| checkOut | string | yes | Check-out date in ISO format (YYYY-MM-DD) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomId | string | yes | The unique identifier of the room (tbStaysRoom.EntryID) |
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 NOMADSTAYS_MCP_AGENT_TOKEN.
No parameter schema on file.
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 NOMADSTAYS_MCP_AGENT_TOKEN.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| title | string | no | OPTIONAL: new title |
| description | string | no | OPTIONAL: new description |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| roomTitle | string | yes | Room name/title |
| roomDescription | string | no | OPTIONAL: room description |
| roomTypeFK | number | no | 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 (whi |
| beds | number | no | OPTIONAL: number of beds |
| maxPerson | number | no | OPTIONAL: max occupancy |
| mainBedSize | string | no | OPTIONAL: main bed size |
| otherBedSize | string | no | OPTIONAL: other bed size, or empty for none |
| roomFacilityFk | array | no | OPTIONAL: facilityDetailId values from getRoomFacilityOptions() — the full set of amenities this room has. Wi-Fi is added automatically even if omitted. |
| mcpRoomId | string | no | 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. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| roomId | number | yes | The room's EntryID (tbStaysRoom) — use getMyStayRooms to find it |
| roomTitle | string | no | — |
| roomDescription | string | no | — |
| roomTypeFK | number | no | A roomTypeId from getRoomTypeOptions(stayId). |
| beds | number | no | — |
| maxPerson | number | no | — |
| mainBedSize | string | no | — |
| otherBedSize | string | no | — |
| roomFacilityFk | array | no | The FULL replacement list of facilityDetailId values from getRoomFacilityOptions() — anything not included will be removed (except Wi-Fi, which is always kept). |
| mcpRoomId | string | no | External MCP room identifier. NOT AVAILABLE for boutique Stays — the host UI has no field for this there, and the API will reject it. |
Delete (soft-delete) a room from a Stay. Requires an MCP agent token scoped to the owning account.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| roomId | number | yes | The room's EntryID — use getMyStayRooms to find it |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
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.
No parameter schema on file.
Delete one photo from a room's gallery. Call getMyStayRooms first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| roomId | number | yes | The room's EntryID |
| roomArea | string | yes | 'photos' for the regular room gallery, 'workspace' for the room's coworking gallery |
| fileName | string | yes | The exact file name from getMyStayRooms |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| roomId | number | yes | The room's EntryID |
| roomArea | string | yes | 'photos' for the regular room gallery, 'workspace' for the room's coworking gallery |
| fileNames | array | yes | The complete gallery file names in the new desired order — must match the current set exactly (call getMyStayRooms first) |
Create a new pricing package on a Stay, optionally with initial price tiers. Requires an MCP agent token scoped to the owning account.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| packageName | string | yes | Package name |
| description | string | no | OPTIONAL: package description |
| roomTypeFK | number | no | OPTIONAL: room type id this package covers. Call getRoomTypeOptions for valid values. |
| stayRoomFK | number | no | 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, which |
| 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 cu |
| maxPax | number | no | OPTIONAL: max occupancy for this package |
| listed | boolean | no | OPTIONAL: whether the package is publicly listed |
| startDate | string | no | OPTIONAL: first check-in date this package is available for |
| endDate | string | no | OPTIONAL: last check-in date this package is available for |
| advertisingEndpoint | string | no | 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 bus |
| prices | array | no | OPTIONAL: initial price tiers. If supplied, replaces all price rows for the package. Exactly one entry per 7/14/21/30-night tier used. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| packageId | number | yes | The package's EntryID (tbStayPackages) |
| packageName | string | no | — |
| description | string | no | — |
| roomTypeFK | number | no | Call getRoomTypeOptions for valid values. |
| stayRoomFK | number | no | The specific room this package covers (tbStaysRoom.EntryID). Call getMyStayRooms to find valid values. |
| currencyFK | number | no | Call getCurrencyOptions for valid values. |
| maxPax | number | no | — |
| listed | boolean | no | — |
| isActive | boolean | no | OPTIONAL: archive (false) or restore (true) this package — cascades to 'listed' on all its price tiers, matching the host UI's Archive/Restore actions |
| startDate | string | no | OPTIONAL: first check-in date this package is available for |
| endDate | string | no | OPTIONAL: last check-in date this package is available for |
| advertisingEndpoint | string | no | OPTIONAL: only usable on Advertising-business-model Stays — ignored otherwise, matching the host UI which hides this field for all other business models. |
| prices | array | no | OPTIONAL: replaces ALL price rows for this package when supplied. Exactly one entry per 7/14/21/30-night tier used. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| packageId | number | yes | The package's EntryID (tbStayPackages) to delete |
List valid currency ids/codes for use as a package's currencyFK.
No parameter schema on file.
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 / g
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| address | string | no | — |
| city | string | no | — |
| state | string | no | — |
| postCode | string | no | — |
| countryId | string | no | A country ID from getCountryOptions — NOT a country name. |
| checkInFrom | string | no | — |
| checkInTo | string | no | — |
| checkOutFrom | string | no | — |
| checkOutTo | string | no | — |
| earlyCheckIn | boolean | no | — |
| lateCheckout | boolean | no | — |
| petsAllowedId | string | no | An optionId from getAdditionalInformationOptions(filterName='Pets Allowed') — NOT a boolean. |
| childrenAllowedId | string | no | An optionId from getAdditionalInformationOptions(filterName='Children Allowed') — NOT a boolean. |
| parkingId | string | no | An optionId from getAdditionalInformationOptions(filterName='Parking') — NOT a boolean. |
| cxPolicyId | string | no | A cxPolicyId from getCancellationPolicyOptions. |
| customCxPolicyLink | string | no | — |
| tourismNumber | string | no | — |
| landRegistrationNumber | string | no | — |
| registeredBusiness | boolean | no | Whether the Stay is officially registered for tourism/lodging |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| businessName | string | no | — |
| vatNumber | string | no | — |
| businessNumber | string | no | — |
| entityAccount | boolean | no | Whether the host operates as a registered business entity |
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 agains
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
| area | string | yes | Which photo area this belongs to: - 'listing': general Stay gallery photos (multiple allowed, min 1920x1080 landscape) - 'main': the single hero/cover photo shown first for the Stay (min 1920x1080 lan |
| url | string | no | A public https:// URL the server can download the image from (e.g. a Google Drive or Dropbox share link). Supply this OR base64, not both. |
| base64 | string | no | Base64-encoded JPEG, PNG, or WebP image bytes (a data:image/...;base64,... URI prefix is also accepted and stripped automatically). Supply this OR url, not both. Under ~27MB encoded (20MB image). |
| roomId | number | no | Required when area is 'room' — the room's EntryID (use getMyStayRooms to find it). Ignored for other areas. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
Update a Stay's contact/owner/manager details and social media links. Only fields supplied are changed. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| ownerName | string | no | — |
| ownerEmail | string | no | — |
| ownerMobile | string | no | — |
| managerName | string | no | The day-to-day contact person's name (not necessarily the owner) |
| managerEmail | string | no | — |
| managerMobile | string | no | — |
| bookingEmail | string | no | Email guests use to reach the Stay about bookings |
| bookingPhone | string | no | — |
| bookingMobile | string | no | — |
| hostFullName | string | no | Display name shown to guests as the host |
| website | string | no | — |
| facebookPage | string | no | — |
| string | no | X (Twitter) profile link | |
| youtube | string | no | — |
| string | no | — | |
| tikTok | string | no | — |
| string | no | — |
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_
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| group | string | yes | Exact facility group name, e.g. 'Languages Spoken', 'General', 'Services', 'Meal', 'Position', 'Remote Worker' (call getFacilityGroups for the full list) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| group | string | yes | Exact facility group name, matching what getMyStayFacilities was called with |
| facilityDetailIds | array | yes | The FULL list of facilityDetailId values that should be selected after this call — call getMyStayFacilities first to see valid IDs. An empty array clears all selections in this group. |
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.
No parameter schema on file.
List valid values for a Stay's 'Main Accommodation Type' (stayTypeId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
No parameter schema on file.
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.
No parameter schema on file.
List valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData). Requires NOMADSTAYS_MCP_AGENT_TOKEN.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filterName | string | yes | Which picklist to fetch options for |
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID (use getMyStays to find it) |
Delete one photo from a Stay. Call getMyStayPhotos first to find the exact fileName. Requires NOMADSTAYS_MCP_AGENT_TOKEN.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| 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' |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stayId | number | yes | The Stay's EntryID |
| area | string | yes | Only these two areas support reordering |
| fileNames | array | yes | The complete gallery file names in the new desired order — must match the current set exactly (call getMyStayPhotos first) |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| productId | number | yes | The product's EntryID — use 8 for the Stay Application fee |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| productId | number | yes | The product's EntryID — use 8 for the Stay Application fee |
| applicationId | number | no | Optional: if this purchase is paying a Stay Application's fee, pass its applicationId (from createStayApplication) so the payment is applied back to that application automatically once paid |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| saleId | string | yes | The saleId returned by purchaseProduct |
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listStayApplications to find it) |
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) a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicantFirstName | string | no | Overrides the profile default for this application only — does not change the member's profile |
| applicantLastName | string | no | Overrides the profile default for this application only — does not change the member's profile |
| applicantEmail | string | no | — |
| mobile | string | no | — |
| businessName | string | no | — |
| street | string | no | — |
| city | string | no | — |
| state | string | no | — |
| zip | string | no | — |
| postalCountryId | number | no | 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 g |
| vatNumber | string | no | Required if the postal country's vatNumberRequired flag is true (see getCountryOptions) |
| stayName | string | no | — |
| stayCountryId | number | no | 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. |
| tourismNumber | string | no | Required if the stay country's tourismNumberRequired flag is true (see getCountryOptions) |
| businessModelId | number | no | tbBusinessModel.EntryID — use getBusinessModelOptions. If the stay country's bookingModelsRestricted flag is true, only a 'StayDirect'-prefixed model is accepted. |
| monthlyPrice | string | no | 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. |
| availabilitySupplier | string | no | — |
| hasKitchen | boolean | no | — |
| laundryFacilities | string | no | — |
| workFacilities | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
| applicantFirstName | string | no | — |
| applicantLastName | string | no | — |
| applicantEmail | string | no | — |
| mobile | string | no | — |
| businessName | string | no | — |
| street | string | no | — |
| city | string | no | — |
| state | string | no | — |
| zip | string | no | — |
| postalCountryId | number | no | tbCountry.CountryId — used only for the VAT check, stored on the business profile, not on the application. Use getCountryOptions. |
| vatNumber | string | no | — |
| stayName | string | no | — |
| stayCountryId | number | no | tbCountry.CountryId — the country the application itself is filed under. Use getCountryOptions. |
| tourismNumber | string | no | — |
| businessModelId | number | no | tbBusinessModel.EntryID — use getBusinessModelOptions. |
| monthlyPrice | string | no | 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. |
| availabilitySupplier | string | no | — |
| hasKitchen | boolean | no | — |
| laundryFacilities | string | no | — |
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 f
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listExperienceApplications to find it) |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicantFirstName | string | no | Overrides the profile default for this application only — does not change the member's profile |
| applicantLastName | string | no | Overrides the profile default for this application only — does not change the member's profile |
| applicantEmail | string | no | — |
| mobile | string | no | — |
| businessName | string | no | — |
| street | string | no | — |
| city | string | no | — |
| state | string | no | — |
| zip | string | no | — |
| postalCountryId | number | no | 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 g |
| vatNumber | string | no | Required if the postal country's vatNumberRequired flag is true (see getCountryOptions) |
| experienceName | string | no | — |
| experienceCountryId | number | no | 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. |
| tourismNumber | string | no | Required if the experience country's tourismNumberRequired flag is true (see getCountryOptions) |
| businessModelId | number | no | tbBusinessModel.EntryID — use getBusinessModelOptions. If the experience country's bookingModelsRestricted flag is true, only a 'StayDirect'-prefixed model is accepted. |
| monthlyPrice | string | no | Price per person (USD) |
| hasInsurance | boolean | no | — |
| availabilitySupplier | string | no | — |
| hasKitchen | boolean | no | — |
| laundryFacilities | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
| applicantFirstName | string | no | — |
| applicantLastName | string | no | — |
| applicantEmail | string | no | — |
| mobile | string | no | — |
| businessName | string | no | — |
| street | string | no | — |
| city | string | no | — |
| state | string | no | — |
| zip | string | no | — |
| postalCountryId | number | no | tbCountry.CountryId — used only for the VAT check, stored on the business profile, not on the application. Use getCountryOptions. |
| vatNumber | string | no | — |
| experienceName | string | no | — |
| experienceCountryId | number | no | tbCountry.CountryId — the country the application itself is filed under. Use getCountryOptions. |
| tourismNumber | string | no | — |
| businessModelId | number | no | tbBusinessModel.EntryID — use getBusinessModelOptions. |
| monthlyPrice | string | no | — |
| hasInsurance | boolean | no | — |
| availabilitySupplier | string | no | — |
| hasKitchen | boolean | no | — |
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. Require
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| packageId | number | yes | The Stay package's ID (from getPackages or search/browse tools) |
| checkIn | string | yes | Check-in date, YYYY-MM-DD |
| checkOut | string | yes | Check-out date, YYYY-MM-DD |
| rooms | number | no | Number of rooms to book. Defaults to 1. |
| adults | number | no | Number of adult guests. Defaults to 1. |
| children | number | no | Number of child guests. Defaults to 0. |
| pets | number | no | Number of pets. Defaults to 0. |
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 can
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteId | string | yes | The quoteId returned by quoteStayBooking |
| contactName | string | no | Guest's full name for the booking. Defaults to the member's account name if omitted. |
| contactEmail | string | no | Contact email for the booking. Defaults to the member's account email if omitted. |
| contactPhone | string | no | Contact phone number for the booking. |
| specialRequest | string | no | Any special request to pass along to the 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 ever returns bookings owned by the caller's own account. Requires NOMADSTAYS_MCP_AGENT_TOKEN with the 'bookings' scope.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pnr | string | yes | The booking reference (PNR) returned by bookStay |
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 notif
No parameter schema on file.
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID (use listCoworkingApplications to find it) |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coworkingName | string | no | — |
| applicantName | string | no | — |
| applicantEmail | string | no | — |
| telephone | string | no | — |
| address | string | no | — |
| city | string | no | — |
| country | string | no | Exact tbCountry.CountryName (not a country ID) — use getCountryOptions and take the countryName field. Must not be a sanctioned country. |
| website | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
| coworkingName | string | no | — |
| applicantName | string | no | — |
| applicantEmail | string | no | — |
| telephone | string | no | — |
| address | string | no | — |
| city | string | no | — |
| country | string | no | Exact tbCountry.CountryName (not a country ID) — use getCountryOptions. |
| website | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| applicationId | number | yes | The application's ID |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Nomad Stays or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.7.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Nomad Stays can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.